Share via


IMDSPDevice::GetStatus

banner art

The GetStatus method retrieves all the device status information that the device can provide.

Syntax

HRESULT GetStatus(DWORD*pdwStatus);

Parameters

pdwStatus

[out]  Pointer to a DWORD that receives the current device status. These status values are defined in the following table.

Status Description
WMDM_STATUS_READY Windows Media Device Manager and its subcomponents are in a ready state.
WMDM_STATUS_BUSY An operation is ongoing. Check other status values to determine which operation it is.
WMDM_STATUS_DEVICE_NOTPRESENT The device is not connected to the computer.
WMDM_STATUS_STORAGE_NOTPRESENT The medium is not present. For devices that support more than one medium, this value is reported only from the IWMDMStorageGlobals interface.
WMDM_STATUS_STORAGE_INITIALIZING The device is currently busy formatting media on the device.
WMDM_STATUS_STORAGE_BROKEN The medium is not working. For devices that support more than one medium, this value is reported only from the IWMDMStorageGlobals interface.
WMDM_STATUS_STORAGE_NOTSUPPORTED The medium is not supported by the device. For devices that support more than one medium, this value is returned only from the IWMDMStorageGlobals interface.
WMDM_STATUS_STORAGE_UNFORMATTED The medium is not formatted. For devices that support more than one medium, this value is returned only from the IWMDMStorageGlobals interface.
WMDM_STATUS_STORAGECONTROL_INSERTING The IWMDMStorageControl::Insert method is currently running.
WMDM_STATUS_STORAGECONTROL_DELETING The IWMDMStorageControl::Delete method is currently running.
WMDM_STATUS_STORAGECONTROL_MOVING The IWMDMStorageControl::Move method is currently running.
WMDM_STATUS_STORAGECONTROL_READING The IWMDMStorageControl::Read method is currently running.

Return Values

The method returns an HRESULT. All the interface methods in Windows Media Device Manager can return any of the following classes of error codes:

  • Standard COM error codes
  • Windows error codes converted to HRESULT values
  • Windows Media Device Manager error codes

For an extenstive list of possible error codes, see Error Codes.

Possible values include, but are not limited to, those in the following table.

Return code Description
E_INVALIDARG The pdwStatus parameter is an invalid or NULL pointer.
E_FAIL An unspecified error occurred.

Remarks

One or more status values can be returned from this call. All the status values of all the interfaces of the media device are reported through this call. For example, if a storage operation, such as writing a file to a media device is ongoing, a call to this method reports the busy status of that operation. For any ongoing operation, the status value WMDM_STATUS_BUSY is always present.

This method must be implemented. It must not return WMDM_E_NOTSUPPORTED or E_NOTIMPL. For more information, see Mandatory and Optional Interfaces.

Requirements

Header: Defined in mswmdm.h.

Library: mssachlp.lib

See Also