White Papers

Virtual Media Profile
Version 1.0.0a 51
4) For each found CIM_USBRedirectionSAP instance, query the value of the EnabledState
property.
5) Count all the CIM_USBRedirectionSAP.EnabledState properties whose value is 2 (Enabled).
9.19 Creating a USB Redirection SAP in Connect Mode
A client can create a USB Redirection SAP as follows:
1) Start at the DCIM_OEMVirtualMediaService instance of interest
2) Inspect the SAPCapabilitiesSupported for the value 2 (Create SAPs) to confirm that creating a
new SAP is supported
3) Invoke the CreateUSBDevice() method with the USB Class and Device Type to create an
instance of a redirected USB device on the system. This invocation returns a reference to an
instance of CIM_USBDevice (usbdevice1); multiple invocations of CreateUSBDevice() can be
made.
4) Invoke the CreateRedirectionSAP() method with an array of references to the CIM_USBDevice
instances from the USBDevices parameter, along with information to create the SAP. The
NewRemoteServiceAccessPoint parameter must have the access information needed to
determine the remote service access point. The NewSAPRequestedStatesSupported parameter
must have the enumeration of the Requested States that will be supported for the SAP, which
will be used to initialize the RequestedStatesSupported property of a new instance of
CIM_EnabledLogicalElementCapabilties that will be associated with the new USB Redirection
SAP by an instance of CIM_ElementCapabilities.
5) When the CreateDevices Boolean parameter is TRUE, in addition to the USB device references
in the USBDevices parameter, CreateRedirectionSAP() method will create new instances of
CIM_USBDevices as specified in the NewUSBDevices parameter and associate them with the
new SAP. Each instance of a concrete subclass of CIM_LogicalDevice specified in the
RedirectedLogicalDevices[] parameter that is not NULL will be associated with the new instance
of CIM_USBDevices that was specified in the same entry in the NewUSBDevices parameter by
a CIM_LogicalIdentity association.
The client starts Virtual Media on the managed node, by performing state management of the
Virtual Media. When enabled, the managed node will attempt to establish a session with the
remote service access point.
9.20 Creating a USB Redirection SAP in Listen Mode
A client can create a USB Redirection SAP as follows:
1) Start at the DCIM_OEMVirtualMediaService instance of interest.
2) Inspect the SAPCapabilitiesSupported for the value 2 (Create SAPs) to confirm that creating a
new SAP is supported.
3) Invoke the CreateUSBDevice() method with the USB Class and Device Type to create an
instance of a redirected USB device on the system. This invocation returns a reference to an
instance of CIM_USBDevice (usbdevice1). Multiple invocations of CreateUSBDevice() can be
made.
4) Invoke the CreateRedirectionSAP() method with an array of references to the CIM_USBDevice
instances, along with information to create the SAP. The NewSAPRequestedStatesSupported
parameter must have the enumeration of the Requested States that will be supported for the
SAP, which will be used to initialize the RequestedStatesSupported property of a new instance
of CIM_EnabledLogicalElementCapabilties that will be associated with the new USB
Redirection SAP by an instance of CIM_ElementCapabilities.