White Papers

Virtual Media Profile
Version 1.0.0a 29
• Creates a CIM_SAPAvailableForElement association between the new
CIM_USBRedirectionSAP and the CIM_ComputerSystem instance that represents the source
of the Virtual Media flow.
• Creates an instance of CIM_EnabledLogicalElementCapabilities and an instance of
CIM_ElementCapablities associating the new instance of CIM_USBRedirectionSAP with the
new instance of CIM_EnabledLogicalElementCapabilities. The properties of the new instance of
CIM_EnabledLogicalElementCapabilities shall have the following values:
a) ElementNameEditSupported shall be FALSE
b) ElementName shall have a value consisting of the ElementName of the newly created
CIM_USBRedirectionSAP with “capabilities” appended
c) InstanceID shall have a value consisting of the value of the Name property of the newly
created CIM_USBRedirectionSAP with “capabilities” appended.
d) RequestedStatesSupported shall have the values specified in the
NewSAPRequestedStatesSupported parameter that are limited to zero or more of the
values in CIM_USBRedirectionCapabilities.RequestedStatesSupportedForCreatedSAP.
• For each instance of CIM_USBDevice referenced in the USBDevices input parameter, creates a
CIM_ServiceAffectsElement association between the CIM_USBDevice and the
DCIM_OEMVirtualMediaService.
• For each instance of CIM_USBDevice referenced in the USBDevices input parameter, creates
an instance of CIM_SAPAvailableForElement associating the CIM_USBDevice and the new
instance of CIM_USBRedirectionSAP
When the CIM_USBRedirectionSAP is created, its properties shall have the values specified in the string-
valued embedded instance of CIM_USBRedirectionSAP specified in the CreateRedirectionSAP method’s
NewUSBRedirectionSAP parameter.
When the CreateUSBDevices parameter is TRUE, the CreateRedirectionSAP method shall perform the
following for each encoded string-valued embedded instance of CIM_USBDevice referenced in the
NewUSBDevices input parameter:
• Create the instance of CIM_USBDevice
• Create an instance of CIM_SAPAvailableForElement associating the CIM_USBDevice and the
new instance of CIM_USBRedirectionSAP
• Create an instance of CIM_ServiceAffectsElement associating the CIM_USBDevice and the
DCIM_OEMVirtualMediaService.
• Create a CIM_LogicalIdentity association between the CIM_USBDevice and the concrete
subclass of CIM_LogicalDevice referenced in Model Correspondence in the
RedirectedLogicalDevices parameter, if the CIM_LogicalDevice REF in the
RedirectedLogicalDevices parameter is not NULL.
If the ConnectionMode parameter has a value of 2 (listen), an instance of CIM_ProtocolEndpoint shall be
associated to the CIM_USBRedirectionSAP using an instance of the CIM_BindsTo association. The
CIM_ProtocolEndpoint may be created if needed, or an existing CIM_ProtocolEndpoint may be used. The
CIM_ProtocolEndpoint properties values are determined and set by the redirection service
implementation.
If the ConnectionMode parameter has a value of 3 (connect), an instance of
CIM_RemoteServiceAccessPoint shall be created based on the string-valued embedded instance
encoded in the NewRemoteServiceAccessPoint parameter and associated to the new
CIM_USBRedirectionSAP using an instance of the CIM_RemoteAccessAvailableToElement association.
The value of the newly created CIM_RemoteServiceAccessPoint.InfoFormat property shall be the same
as one of the values specified in CIM_USBRedirectionCapabilities.InfoFormatsSupported.