IMDSPDevice::GetStatus-Methode (mswmdm.h)
Die GetStatus-Methode ruft alle Geräte status Informationen ab, die das Gerät bereitstellen kann.
Syntax
HRESULT GetStatus(
[out] DWORD *pdwStatus
);
Parameter
[out] pdwStatus
Zeiger auf ein DWORD, das das aktuelle Gerät status empfängt. Diese status Werte werden in der folgenden Tabelle definiert.
| Status | BESCHREIBUNG |
|---|---|
| WMDM_STATUS_READY | Windows Media-Geräte-Manager und die zugehörigen Unterkomponenten sind bereit. |
| WMDM_STATUS_BUSY | Ein Vorgang wird ausgeführt. Überprüfen Sie andere status Werte, um zu ermitteln, um welchen Vorgang es sich handelt. |
| WMDM_STATUS_DEVICE_NOTPRESENT | Das Gerät ist nicht mit dem Computer verbunden. |
| WMDM_STATUS_STORAGE_NOTPRESENT | Das Medium ist nicht vorhanden. Bei Geräten, die mehr als ein Medium unterstützen, wird dieser Wert nur von der IWMDMStorageGlobals-Schnittstelle gemeldet. |
| WMDM_STATUS_STORAGE_INITIALIZING | Das Gerät ist derzeit mit dem Formatieren von Medien auf dem Gerät beschäftigt. |
| WMDM_STATUS_STORAGE_BROKEN | Das Medium funktioniert nicht. Bei Geräten, die mehr als ein Medium unterstützen, wird dieser Wert nur von der IWMDMStorageGlobals-Schnittstelle gemeldet. |
| WMDM_STATUS_STORAGE_NOTSUPPORTED | Das Medium wird vom Gerät nicht unterstützt. Bei Geräten, die mehr als ein Medium unterstützen, wird dieser Wert nur von der IWMDMStorageGlobals-Schnittstelle zurückgegeben. |
| WMDM_STATUS_STORAGE_UNFORMATTED | Das Medium ist nicht formatiert. Bei Geräten, die mehr als ein Medium unterstützen, wird dieser Wert nur von der IWMDMStorageGlobals-Schnittstelle zurückgegeben. |
| WMDM_STATUS_STORAGECONTROL_INSERTING | Die IWMDMStorageControl::Insert-Methode wird derzeit ausgeführt. |
| WMDM_STATUS_STORAGECONTROL_DELETING | Die IWMDMStorageControl::D elete-Methode wird derzeit ausgeführt. |
| WMDM_STATUS_STORAGECONTROL_MOVING | Die IWMDMStorageControl::Move-Methode wird derzeit ausgeführt. |
| WMDM_STATUS_STORAGECONTROL_READING | Die IWMDMStorageControl::Read-Methode wird derzeit ausgeführt. |
Rückgabewert
Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:
- Standard-COM-Fehlercodes
- In HRESULT-Werte konvertierte Windows-Fehlercodes
- Windows Media Geräte-Manager Fehlercodes
Hinweise
Ein oder mehrere status Werte können von diesem Aufruf zurückgegeben werden. Alle status Werte aller Schnittstellen des Mediengeräts werden über diesen Aufruf gemeldet. Wenn beispielsweise ein Speichervorgang wie das Schreiben einer Datei auf ein Mediengerät ausgeführt wird, meldet ein Aufruf dieser Methode die ausgelasteten status dieses Vorgangs. Bei jedem laufenden Vorgang ist der status Wert WMDM_STATUS_BUSY immer vorhanden.
Diese Methode muss implementiert werden. Es darf keine WMDM_E_NOTSUPPORTED oder E_NOTIMPL zurückgeben. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | mswmdm.h |
| Bibliothek | Mssachlp.lib |