IMDSPDevice::GetStatus-Methode (mswmdm.h)

Artikel
02/29/2024

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

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