IMMNotificationClient::OnDeviceStateChanged-Methode (mmdeviceapi.h)

  • Artikel

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

Weitere Informationen

IMMNotificationClient-Schnittstelle