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 |