IMDSPStorageGlobals::GetStatus-Methode (mswmdm.h)
Die GetStatus-Methode ruft den aktuellen status des Speichermediums ab.
Syntax
HRESULT GetStatus(
[out] DWORD *pdwStatus
);
Parameter
[out] pdwStatus
Zeiger auf eine DWORD-Instanz, die die status Informationen enthält. Die folgenden status-Werte können vom pdwStatus-Parameter zurückgegeben werden.
| Status | BESCHREIBUNG |
|---|---|
| WMDM_STATUS_READY | Das Medium befindet sich in einem Leerlaufzustand, der bereit ist. |
| WMDM_STATUS_BUSY | Ein Vorgang wird ausgeführt. Bewerten Sie status Werte, um den laufenden Vorgang zu ermitteln. |
| WMDM_STATUS_STORAGE_NOTPRESENT | Das Medium ist nicht vorhanden. Für Geräte, die mehrere Medien unterstützen, wird dieser Wert nur von der IMDSPStorageGlobals-Schnittstelle gemeldet. |
| WMDM_STATUS_STORAGE_INITIALIZING | Das Gerät ist derzeit mit dem Formatieren von Medien auf einem Gerät beschäftigt. |
| WMDM_STATUS_STORAGE_BROKEN | Das Medium ist unterbrochen. Für Geräte, die mehrere Medien unterstützen, wird dieser Wert nur von der IMDSPStorageGlobals-Schnittstelle gemeldet. |
| WMDM_STATUS_STORAGE_NOTSUPPORTED | Das Medium wird vom Gerät nicht unterstützt. Für Geräte, die mehrere Medien unterstützen, wird dieser Wert nur von der IMDSPStorageGlobals-Schnittstelle zurückgegeben. |
| WMDM_STATUS_STORAGE_UNFORMATTED | Das Medium ist nicht formatiert. Für Geräte, die mehrere Medien unterstützen, wird dieser Wert nur von der IMDSPStorageGlobals-Schnittstelle gemeldet. |
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:
- Com-Standardfehlercodes
- In HRESULT-Werte konvertierte Windows-Fehlercodes
- Windows Media Geräte-Manager Fehlercodes
Hinweise
Sie müssen diese Methode immer aufrufen, bevor Sie versuchen, mit einem Speichermedium zu interagieren. Der zurückgegebene status Wert wird WMDM_STATUS_BUSY, wenn eine andere Schnittstelle einen laufenden Vorgang aufgerufen hat. Sie können den von diesem Aufruf zurückgegebenen Wert auswerten, um zu ermitteln, ob ein laufender Vorgang von der IMDSPStorageGlobals-Schnittstelle aufgerufen wurde.
Diese Methode muss implementiert werden. Es darf keine WMDM_E_NOTSUPPORTED oder E_NOTIMPL zurückgegeben werden. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | mswmdm.h |
| Bibliothek | Mssachlp.lib |