Skip to content

Latest commit

 

History

History
146 lines (124 loc) · 5.48 KB

nf-mswmdm-imdspdevice-getstatus.md

File metadata and controls

146 lines (124 loc) · 5.48 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:mswmdm.IMDSPDevice.GetStatus
IMDSPDevice::GetStatus (mswmdm.h)
The GetStatus method retrieves all the device status information that the device can provide.
GetStatus
GetStatus method [windows Media Device Manager]
GetStatus method [windows Media Device Manager]
IMDSPDevice interface
IMDSPDevice interface [windows Media Device Manager]
GetStatus method
IMDSPDevice.GetStatus
IMDSPDevice::GetStatus
IMDSPDeviceGetStatus
mswmdm/IMDSPDevice::GetStatus
wmdm.imdspdevice_getstatus
wmdm\imdspdevice_getstatus.htm
WMDM
76c5ee43-4d21-436e-b193-8a8e034651f0
12/05/2018
GetStatus, GetStatus method [windows Media Device Manager], GetStatus method [windows Media Device Manager],IMDSPDevice interface, IMDSPDevice interface [windows Media Device Manager],GetStatus method, IMDSPDevice.GetStatus, IMDSPDevice::GetStatus, IMDSPDeviceGetStatus, mswmdm/IMDSPDevice::GetStatus, wmdm.imdspdevice_getstatus
mswmdm.h
Windows
Mssachlp.lib
Windows
19H1
IMDSPDevice::GetStatus
mswmdm/IMDSPDevice::GetStatus
c++
APIRef
kbSyntax
COM
mssachlp.lib
mssachlp.dll
IMDSPDevice.GetStatus

IMDSPDevice::GetStatus

-description

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

-parameters

-param 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.

-returns

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 extensive list of possible error codes, see Error Codes.

-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.

-see-also

IMDSPDevice Interface

IWMDMStorageControl Interface

IWMDMStorageGlobals Interface