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

Eine ausführliche Liste möglicher Fehlercodes finden Sie unter 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

Weitere Informationen

IMDSPStorageGlobals-Schnittstelle