IWMDMStorageGlobals::GetStatus-Methode (mswmdm.h)
Die GetStatus-Methode ruft die aktuelle status eines Speichermediums ab.
Syntax
HRESULT GetStatus(
[out] DWORD *pdwStatus
);
Parameter
[out] pdwStatus
Zeiger auf ein DWORD, um die status Informationen zu erhalten, wenn die Methode zurückgibt. Die folgenden Werte können im pdwStatus-Parameter zurückgegeben werden.
| Status | BESCHREIBUNG |
|---|---|
| WMDM_STATUS_READY | Das Medium befindet sich im Leerlauf- oder Bereitzustand. |
| WMDM_STATUS_BUSY | Ein Vorgang wird ausgeführt. Werten Sie status Werte aus, um den laufenden Vorgang zu bestimmen. |
| WMDM_STATUS_STORAGE_NOTPRESENT | Das Speichermedium ist nicht vorhanden. Bei Geräten mit mehr als einem unterstützten Medium wird dieser Wert nur von der IWMDMStorageGlobals-Schnittstelle gemeldet. |
| WMDM_STATUS_STORAGE_INITIALIZING | Das Gerät ist derzeit damit beschäftigt, ein Speichermedium auf einem Gerät zu formatieren. |
| WMDM_STATUS_STORAGE_BROKEN | Das Speichermedium ist beschädigt. Bei Geräten mit mehr als einem unterstützten Medium wird dieser Wert nur von der IWMDMStorageGlobals-Schnittstelle gemeldet. |
| WMDM_STATUS_STORAGE_NOTSUPPORTED | Das Speichermedium wird vom Gerät nicht unterstützt. Bei Geräten mit mehr als einem unterstützten Medium wird dieser Wert nur von der IWMDMStorageGlobals-Schnittstelle zurückgegeben. |
| WMDM_STATUS_STORAGE_UNFORMATTED | Das Speichermedium ist nicht formatiert. Bei Geräten mit mehr als einem unterstützten Medium wird dieser Wert nur von der IWMDMStorageGlobals-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:
- Standard-COM-Fehlercodes
- In HRESULT-Werte konvertierte Windows-Fehlercodes
- Windows Media Geräte-Manager Fehlercodes
Hinweise
Diese Methode muss immer aufgerufen werden, bevor der Aufrufer versucht, mit einem Speichermedium zu interagieren. Der abgerufene status Wert ist WMDM_STATUS_BUSY, wenn eine andere Schnittstelle einen laufenden Vorgang aufgerufen hat. Sie können den von diesem Aufruf abgerufenen Wert auswerten, um zu bestimmen, ob ein laufender Vorgang von der IWMDMStorageGlobals-Schnittstelle aufgerufen wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | mswmdm.h |
| Bibliothek | Mssachlp.lib |