IMMDevice::GetState-Methode (mmdeviceapi.h)

  • Artikel

Die GetState-Methode ruft den aktuellen Gerätestatus ab.

Syntax

HRESULT GetState(
  [out] DWORD *pdwState
);

Parameter

[out] pdwState

Zeiger auf eine DWORD-Variable , in die die Methode den aktuellen Zustand des Geräts schreibt. Der Gerätestatuswert ist eine der folgenden DEVICE_STATE_XXX Konstanten:

DEVICE_STATE_ACTIVE

DEVICE_STATE_DISABLED

DEVICE_STATE_NOTPRESENT

DEVICE_STATE_UNPLUGGED

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.

Rückgabecode Beschreibung
E_POINTER
 Der Parameter pdwState ist NULL.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mmdeviceapi.h

Weitere Informationen

IMMDevice-Schnittstelle