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 |
|---|---|
|
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 |