White Papers

Virtual Media Profile
Version 1.0.0a 27
Table 3 – DCIM_OEMVirtualMediaService.RequestStateChange( ) Method: Parameters
Qualifiers Name Type Description/Values
IN RequestedState uint16 Valid state values:
2 (Enabled) – attach virtual media device
3 (Disabled) – detach virtual media device
6 (Offline) – auto attach virtual media device
OUT Job CIM_ConcreteJob REF Returned if job started
IN TimeoutPeriod datetime
Client-specified maximum amount of time
the transition to a new state is supposed to
take:
0 or NULL – No time requirements
<interval> – Maximum time allowed
8.1.1 DCIM_OEMVirtualMediaService.RequestStateChange( )—Conditional Support
When an instance of CIM_USBRedirectionCapabilities is associated with the
DCIM_OEMVirtualMediaService instance and the
CIM_USBRedirectionCapabilities.RequestedStatesSupported property contains at least one value, the
DCIM_OEMVirtualMediaService.RequestStateChange(
) method shall be implemented and supported.
The DCIM_OEMVirtualMediaService.RequestStateChange(
) method shall not return a value of 1 (Not
Supported).
8.2 DCIM_OEMVirtualMediaService.ResetFlashKeySize( )
Invocation of the ResetFlashKeySize ( ) method requests a reset of the flash key size when the Emulated
USB Device is surfaced as a USB mass storage flash key to the impacted managed system.
Return codes of the ResetFlashKeySize(
) method are specified in Table 2 and Table 3.
No standard messages are defined.
Table 4 – DCIM_OEMVirtualMediaService.RequestStateChange(
) Method: Return Code Values
Value Description
0 Request was successfully executed.
1 Method is unsupported.
2 Error occurred.
4096 Job started: REF returned to started CIM_ConcreteJob.
8.2.1 DCIM_OEMVirtualMediaService.ResetFlashKeySize( ) —Conditional Support
If the DCIM_OEMVirtualMediaService.FlashKeyEnabled is not NULL, the
DCIM_OEMVirtualMediaService.ResetFlashKeySize(
) method shall be implemented and shall not return
a value of 1 (Not Supported).
If the DCIM_OEMVirtualMediaService.FlashKeyEnabled is NULL, the
DCIM_OEMVirtualMediaService.ResetFlashKeySize(
) method shall not be implemented or shall return a
value of 1 (Not Supported).
8.3 DCIM_OEMVirtualMediaService.CreateUSBDevice( )
This method is conditional on the CIM_USBRedirectionCapabilities.SAPCapabilitiesSupported property
array containing a value of 2 (Create SAPs). For more information, see section 7.3.3.