White Papers

Virtual Media Profile
Version 1.0.0a 17
7.3.3 SAPCapabilitiesSupported
When there is an instance of CIM_USBRedirectionCapabilities associated with the instance of
DCIM_OEMVirtualMediaService, the CIM_USBRedirectionCapabilities.SAPCapabilitiesSupported array
property shall contain values that specify whether the static pre-configured USB Redirection SAPs exist.
This property can be used by the remote client to determine whether the static pre-configured USB
Redirection SAPs that exist can be inspected and whose states can be managed, or whether the creation
of a USB Redirection SAP is required. An implementation may have static pre-configured USB
Redirection SAPs and still support the creation of more USB Redirection SAPs.
When the SAPCapabilitiesSupported array property contains a value of 2 (Pre-configured SAPs), then
instances of CIM_USBRedirectionSAP and CIM_USBDevice shall exist and instances of
CIM_ProtocolEndpoint and CIM_RemoteServiceAccessPoint may exist.
When the SAPCapabilitiesSupported array property contains a value of 3 (Create SAPs), then instances
of CIM_USBRedirectionSAP, CIM_USBDevice, CIM_ProtocolEndpoint, and
CIM_RemoteServiceAccessPoint may exist. In addition, the CreateUSBDevice(),
CreateRedirectionSAP() and DeleteRedirectionSAP() shall be implemented and shall not return
“NotSupported”.
When the SAPCapabilitiesSupported array property contains a value of 4 (Modify SAP), then the
properties of instances of CIM_USBRedirectionSAP associated with the instance of
DCIM_OEMVirtualMediaService may be modified by “ModifyInstance”.
If the SAPCapabilitiesSupported array property contains a value of 32768 (DCIM Modify
TCPProtocolEndpoint), then the properties of CIM_TCPProtocolEndpoint instances associated with the
instance of CIM_USBRedirectionSAP through a CIM_BindsTo association that is also associated with
DCIM_OEMVirtualMediaService may be modified by “ModifyInstance”.
7.3.4 Requested states supported for created SAPs
When there is an instance of CIM_USBRedirectionCapabilities associated with the instance of
DCIM_OEMVirtualMediaService, and CIM_USBRedirectionCapabilities.SAPCapabilitiesSupported
contains the value 3 (Create SAPs), the
CIM_USBRedirectionCapabilities.RequestedStatesSupportedForCreatedSAP shall contain the
enumerated values that the Virtual Media Service can support for the RequestedStatesSupported
property of the CIM_EnabledLogicalElementCapabilties instance that will be associated with SAPs
created by the DCIM_OEMVirtualMediaService.CreateRedirectionSAP method. See section 8.4 for
details o
n how the RequestedStatusSupport property is set.
7.3.5 SingleClassPerSAP
When there is an instance of CIM_USBRedirectionCapabilities associated with the instance of
DCIM_OEMVirtualMediaService, and the CIM_USBRedirectionCapabilities.SingleClassPerSAP has a
value of TRUE, only instances of CIM_USBDevice whose ClassCode property have the same value as
each other shall be associated with the same instance of CIM_USBRedirectionSAP.
7.3.6 MaxDevicesPerSAP
When there is an instance of CIM_USBRedirectionCapabilities associated with the instance of
DCIM_OEMVirtualMediaService, the CIM_USBRedirectionCapabilities.MaxDevicesPerSAP property shall
contain a value specifying the maximum number of devices that are supported by the Virtual Media
Service for a single USB Redirection SAP. This value shall not exceed the value of
CIM_USBRedirectionCapabilities.MaxDevicesSupported