FOREWORD

2Service Modeling Definitions

2.1ServiceType

2.2State Variables

2.2.1XML Fragments as UPnP Arguments

2.2.2A_ARG_TYPE_TrafficDescriptor

2.2.2.1XML Schema Definition

2.2.3A_ARG_TYPE_TrafficDescriptorsPerlnterface

2.2.3.1XML Schema Definition

2.2.3.2Description of fields in the TrafficDescriptorsPerInterface structure

2.2.3.3Sample argument XML string

2.2.4A_ARG_TYPE_TrafficHandle

2.2.5A_ARG_TYPE_NumTrafficDescriptors

2.2.6A_ARG_TYPE_QosDeviceCapabilities

2.2.6.1XML Schema Definition

2.2.6.2Description of fields in the QosDeviceCapabilities structure

2.2.6.3Sample argument XML string

2.2.7A_ARG_TYPE_QosDeviceState

2.2.7.1XML Schema Definition

2.2.7.2Description of fields in the A_ARG_TYPE_QosDeviceState structure

2.2.7.3Description of fields in the Interface structure

2.2.7.4Sample argument XML string

2.2.8PathInformation

2.2.8.1XML Schema Definition

2.2.8.2Description of fields in PathInformation structure

2.2.8.3Description of fields in DeviceReachableMacs structure

2.2.8.4Description of fields in LinkReachableMacs structure

2.2.8.5Sample argument XML string - PC with two network interfaces

2.2.9A_ARG_TYPE_QosDeviceInfo

2.2.9.1XML Schema Definition

2.2.9.2Description of fields in A_ARG_TYPE_QosDevicelnfo structure

2.2.9.3Sample argument XML string

2.2.10A_ARG_TYPE_QosStateId

2.2.11A_ARG_TYPE_NumRotameterObservations

2.2.12A_ARG_TYPE_RotameterInformation

2.2.12.1XML Schema Definition

2.2.12.2Description of fields in A_ARG_TYPE_RotameterInformation structure

2.2.12.3Description of fields in the RotameterObservation structure

2.2.12.4Description of fields in the ROPerStreamObservation structure

2.2.12.5Sample argument XML string - PC with two network interfaces

2.2.12.6Sample argument XML string - PC with two network interfaces that are both end point device

2.2.13A_ARG_TYPE_ConfRotameterObservations

2.2.13.1XML Schema Definition

2.2.13.2Description of fields in A_ARG_TYPE_ConfRotameterObservations structure

2.2.13.3Description of fields in PerStreamConfiguration structure

2.2.13.4Sample argument XML string

2.2.14MostRecentStreamAction

2.2.14.1XML Schema Definition

2.2.14.2Description of fields in the MostRecentStreamAction structure

2.2.14.3Sample Argument XML String

2.2.15A_ARG_TYPE_MaxPossibleRotameterObservations

2.2.16A_ARG_TYPE_Resource

2.2.16.1XML Schema Definition

2.2.16.2Description of fields in A_ARG_TYPE_Resource structure

2.2.16.3Description of fields in DeviceResource structure

2.2.16.4Description of fields in NetworkResource structure

2.2.16.5Sample Argument XML String

2.2.17A_ARG_TYPE_AdmitTrafficQosExtendedResult

2.2.17.1XML Schema Definition

2.2.17.2Description of fields in A_ARG_TYPE_AdmitTrafficQosExtendedResult structure

2.2.17.3Description of fields in the AdmissionStatusNet structure

2.2.17.4Description of fields in the AllocatedResources structure

2.2.17.5Description of fields in the AdmissionStatusDev structure

2.2.17.6Description of fields in the ListOfLayer2StreamIds structure

2.2.17.7Description of fields in the Layer2Stream structure

2.2.17.8Sample argument XML string

2.2.18A_ARG_TYPE_ListOfAdmittedTraffic

2.2.18.1XML Schema Definition

2.2.18.2Description of fields in the ListOfAdmittedTraffic structure

2.2.18.3Description of fields in the AdmittedTrafficltem structure

2.2.18.3.1Description of the fields in the NetworkResource structure

2.2.18.3.2Description of the fields in DeviceResource structure

2.2.18.4Sample argument XML string

2.2.19A_ARG_TYPE_PreferredQph

2.2.19.1XML Schema Definition

2.2.19.2Description of fields in the PreferredQph structure

2.2.19.3Sample argument XML string

2.2.20UnexpectedStreamChange

2.2.21A_ARG_TYPE_PreemptingTrafficInfo

2.2.21.1XML Schema Definition

2.2.21.2Description of fields in the PreemptingTrafficInfo structure

2.2.21.3Sample argument XML string

2.2.22A_ARG_TYPE_ListOfMostRecentUnexpectedStreamChanges

2.2.22.1XML Schema Definition

2.2.22.2Description of fields in the ListOfMostRecentUnexpectedStreamChanges structure

2.2.22.3Description of fields in the UnexpectedStreamChange structure

2.2.22.4Sample argument XML string

2.2.23A_ARG_TYPE_QosDeviceExtendedState

2.2.23.1XML Schema Definition

2.2.23.2Description of fields and organization in the QosDeviceExtendedState structure

2.2.23.3Description of fields in the ListOfProtoTspecs structure

2.2.23.4ProtoTspec

2.2.23.5Description of fields in the Parameter structure

2.2.23.6Sample argument XML string

2.2.24A_ARG_TYPE_Layer2Mapping

2.2.24.1XML Schema Definition

2.2.24.2Description of fields in the A_ARG_TYPE_Layer2Mappinq state variable

2.2.24.3Sample argument XML string

2.2.25A_ARG_TYPE_AdmitTrafficQosSucceeded

2.2.26A_ARG_TYPE_TrafficDescriptorsWanted

2.2.27A_ARG_TYPE_SetPreferredQphResults

2.2.28A_ARG_TYPE_ NumberOfUnexpectedStreamChangesRequested

2.2.29A_ARG_TYPE_ NumberOfUnexpectedStreamChangesReported

2.2.30A_ARG_TYPE_NewTrafficLeaseTime

2.2.31A_ARG_TYPE_TrafficDescriptorContainer

2.2.31.1XML Schema Definition

2.2.31.2Description of fields in the A_ARG_TYPE_TrafficDescriptorContainer state variable

2.2.31.3Sample argument XML string

2.2.32A_ARG_TYPE_Layer2MappingContainer

2.2.32.1XML Schema Definition

2.2.32.2Description of fields in the A_ARG_TYPE_Layer2Mappinq Container state variable

2.2.32.3Sample argument XML string

2.2.33A_ARG_TYPE_QosDeviceInfoContainer

2.2.33.1XML Schema Definition

2.2.33.2Description of fields in the A_ARG_TYPE_QosDeviceInfo Container state variable

2.2.33.3Sample argument XML string

2.3Eventing and Moderation

2.3.1Event Model

2.4Actions

2.4.1GetQosDeviceCapabilities()

2.4.1.1Arguments

2.4.1.2Service requirements

2.4.1.3Control Point requirements when calling the action

2.4.1.4Dependency on State (if any)

2.4.1.5Effect on State (if any)

2.4.1.6Errors

2.4.2GetQosState()

2.4.2.1Arguments

2.4.2.2Service requirements

2.4.2.3Control Point requirements when calling the action

2.4.2.4Dependency on State (if any)

2.4.2.5Effect on State (if any)

2.4.2.6Errors

2.4.3SetupTrafficQos()

2.4.3.1Arguments

2.4.3.2Service requirements

2.4.3.3Control Point requirements when calling the action

2.4.3.4Dependency on State (if any)

2.4.3.5Effect on State (if any)

2.4.3.6Errors

2.4.4ReleaseTrafficQos()

2.4.4.1Arguments

2.4.4.2Service requirements

2.4.4.3Control Point requirements when calling the action

2.4.4.4Dependency on State (if any)

2.4.4.5Effect on State (if any)

2.4.4.6Errors

2.4.5GetPathlnformation

2.4.5.1Arguments

2.4.5.2Service requirements

2.4.5.3Control Point requirements when calling the action

2.4.5.4Dependency on State (if any)

2.4.5.5Effect on State (if any)

2.4.5.6Errors

2.4.6GetQosDevicelnfo()

2.4.6.1Arguments

2.4.6.2Service requirements

2.4.6.3Control Point requirements when calling the action

2.4.6.4Dependency on State (if any)

2.4.6.5Effect on State (if any)

2.4.6.6Errors

2.4.7ConfigureRotameterObservation()

2.4.7.1Arguments

2.4.7.2Service requirements

2.4.7.3Dependency on State (if any)

2.4.7.4Control Point requirements when calling the action

2.4.7.5Effect on State (if any)

2.4.7.6Errors

2.4.8GetRotameterlnformation()

2.4.8.1Arguments

2.4.8.2Service requirements

2.4.8.3Control Point requirements when calling the action

2.4.8.4Dependency on State (if any)

2.4.8.5Effect on State (if any)

2.4.8.6Errors

2.4.9AdmitTrafficQos()

2.4.9.1Arguments

2.4.9.2Service requirements

2.4.9.2.1How to Calculate MaxCommittedDelay

2.4.9.3Control Point requirements when calling the action

2.4.9.4Dependency on State (if any)

2.4.9.5Effect on State (if any)

2.4.9.6Errors

2.4.9.7Reason Codes

2.4.10UpdateAdmittedQos()

2.4.10.1Arguments

2.4.10.2Service requirements

2.4.10.3Control Point requirements when calling the action

2.4.10.4Dependency on State (if any)

2.4.10.5Effect on State (if any)

2.4.10.6Errors

2.4.10.7Reason Codes

2.4.11ReleaseAdmittedQos()

2.4.11.1Arguments

2.4.11.2Service requirements

2.4.11.3Control Point requirements when calling the action

2.4.11.4Dependency on State (if any)

2.4.11.5Effect on State (if any)

2.4.11.6Errors

2.4.12GetExtendedQosState()

2.4.12.1Arguments

2.4.12.2Service requirements

2.4.12.3Control Point requirements when calling the action

2.4.12.4Dependency on State (if any)

2.4.12.5Effect on State (if any)

2.4.12.6Errors

2.4.13SetPreferredQph()

2.4.13.1Arguments

2.4.13.2Service requirements

2.4.13.3Control Point requirements when calling the action

2.4.13.4Dependency on State (if any)

2.4.13.5Effect on State (if any)

2.4.13.6Errors

2.4.14GetUnexpectedStreamChanges()

2.4.14.1Arguments

2.4.14.2Service requirements

2.4.14.3Control Point requirements when calling the action

2.4.14.4Dependency on State (if any)

2.4.14.5Effect on State (if any)

2.4.14.6Errors

2.4.15VerifyTrafficHandle()

2.4.15.1Arguments

2.4.15.2Service requirements

2.4.15.3Control Point requirements when calling the action

2.4.15.4Dependency on State (if any)

2.4.15.5Effect on State (if any)

2.4.15.6Errors

2.4.16UpdateTrafficLeaseTime()

2.4.16.1Arguments

2.4.16.2Service requirements

2.4.16.3Control Point requirements when calling the action

2.4.16.4Dependency on State (if any)

2.4.16.5Effect on State (if any)

2.4.16.6Errors

2.4.17SetL2Map()

2.4.17.1Arguments

2.4.17.2Service requirements

2.4.17.3Control Point requirements when calling the action

2.4.17.4Dependency on State (if any)

2.4.17.5Effect on State (if any)

2.4.17.6Errors

2.4.18Non-Standard Actions Implemented by a UPnP Vendor

2.4.19Error Code Summary

2.4.20Reason Code Summary

2.5Theory of Operation (Informative)

2.5.1Parameterized QoS

2.5.2Prioritized QoS

2.5.2.1Prioritized QoS usage by Control Points designed for version 3

2.5.2.2Prioritized QoS usage by Control Points designed for version 2

2.5.3Hybrid QoS