IMMNotificationClient：：OnPropertyValueChanged 方法 (mmdeviceapi.h)

OnPropertyValueChanged 方法表示屬於音訊端點裝置的屬性值已變更。

語法

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

[in] pwstrDeviceId

識別音訊端點裝置的端點標識符字串指標。此參數指向包含端點標識碼的 Null 終止寬字元字串。字串在呼叫期間維持有效狀態。

[in] key

指定屬性的 PROPERTYKEY 結構。結構包含屬性集 GUID 和識別集合內屬性的索引。結構會以值傳遞。在通話期間，它會維持有效狀態。如需 PROPERTYKEY 的詳細資訊，請參閱 Windows SDK 檔。

如果方法成功，它會傳回 S_OK。如果方法失敗，則會傳回錯誤碼。

成功變更音頻端點裝置屬性值的 IPropertyStore：：SetValue 方法呼叫會產生 對 OnPropertyValueChanged 的呼叫。如需 IPropertyStore：：SetValue 的詳細資訊，請參閱 Windows SDK 檔。

用戶端可以使用 key 參數來擷取新的屬性值。如需使用屬性索引鍵從端點裝置屬性存放區擷取屬性值的程式代碼範例，請參閱裝置屬性。

如需實作 OnPropertyValueChanged 方法的程式代碼範例，請參閱裝置事件。