IMMDevice::GetState-Methode (mmdeviceapi.h)

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