IMMNotificationClient::OnDeviceStateChanged-Methode (mmdeviceapi.h)
Die OnDeviceStateChanged-Methode gibt an, dass sich der Zustand eines Audioendpunktgeräts geändert hat.
Syntax
HRESULT OnDeviceStateChanged(
[in] LPCWSTR pwstrDeviceId,
[in] DWORD dwNewState
);
Parameter
[in] pwstrDeviceId
Zeiger auf die Endpunkt-ID-Zeichenfolge , die das Audioendpunktgerät identifiziert. Dieser Parameter verweist auf eine MIT NULL endende Breitzeichenzeichenfolge, die die Endpunkt-ID enthält. Die Zeichenfolge bleibt für die Dauer des Aufrufs gültig.
[in] dwNewState
Gibt den neuen Zustand des Endpunktgeräts an. Der Wert dieses Parameters 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. Bei einem Fehler wird ein Fehlercode zurückgegeben.
Hinweise
Ein Codebeispiel, das die OnDeviceStateChanged-Methode implementiert, finden Sie unter Geräteereignisse.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mmdeviceapi.h |