IMMNotificationClient::OnPropertyValueChanged-Methode (mmdeviceapi.h)

Die OnPropertyValueChanged-Methode gibt an, dass sich der Wert einer Eigenschaft, die zu einem Audioendpunktgerät gehört, geändert hat.

Syntax

HRESULT OnPropertyValueChanged(
  [in] LPCWSTR           pwstrDeviceId,
  [in] const PROPERTYKEY key
);

Parameter

[in] pwstrDeviceId

Zeiger auf die Endpunkt-ID-Zeichenfolge , die das Audioendpunktgerät identifiziert. Dieser Parameter verweist auf eine MIT NULL beendete breitzeichenige Zeichenfolge, die die Endpunkt-ID enthält. Die Zeichenfolge bleibt für die Dauer des Aufrufs gültig.

[in] key

Eine PROPERTYKEY-Struktur , die die -Eigenschaft angibt. Die Struktur enthält die Eigenschaftssatz-GUID und einen Index, der eine Eigenschaft innerhalb des Satzes identifiziert. Die Struktur wird als Wert übergeben. Sie bleibt für die Dauer des Anrufs gültig. Weitere Informationen zu PROPERTYKEY finden Sie in der Windows SDK-Dokumentation.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Hinweise

Ein Aufruf der IPropertyStore::SetValue-Methode , die den Wert einer Eigenschaft eines Audioendpunktgeräts erfolgreich ändert, generiert einen Aufruf von OnPropertyValueChanged. Weitere Informationen zu IPropertyStore::SetValue finden Sie in der Windows SDK-Dokumentation.

Ein Client kann den Schlüsselparameter verwenden, um den neuen Eigenschaftswert abzurufen. Ein Codebeispiel, das einen Eigenschaftenschlüssel verwendet, um einen Eigenschaftswert aus dem Eigenschaftenspeicher eines Endpunktgeräts abzurufen, finden Sie unter Geräteeigenschaften.

Ein Codebeispiel, das die OnPropertyValueChanged-Methode implementiert, finden Sie unter Geräteereignisse.

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

IMMNotificationClient-Schnittstelle