IWMDMStorageGlobals::GetStatus-Methode (mswmdm.h)

  • Artikel

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

Weitere Informationen

IWMDMStorageGlobals-Schnittstelle