IMMNotificationClient：：OnPropertyValueChanged 方法 (mmdeviceapi.h)

OnPropertyValueChanged 方法指示属于音频终结点设备的属性的值已更改。

语法

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

[in] pwstrDeviceId

指向标识音频终结点设备的终结点 ID 字符串的指针。此参数指向包含终结点 ID 的以 null 结尾的宽字符字符串。字符串在调用期间保持有效。

[in] key

一个指定属性的 PROPERTYKEY 结构。结构包含属性集 GUID 和标识集中属性的索引。结构按值传递。它在调用期间仍然有效。有关 PROPERTYKEY 的详细信息，请参阅Windows SDK文档。

如果该方法成功，则它会返回 S_OK。如果该方法失败，则会返回错误代码。

调用成功更改音频终结点设备的属性值的 IPropertyStore：：SetValue 方法会生成对 OnPropertyValueChanged 的调用。有关 IPropertyStore：：SetValue 的详细信息，请参阅Windows SDK文档。

客户端可以使用 key 参数来检索新的属性值。有关使用属性键从终结点设备的属性存储中检索属性值的代码示例，请参阅设备属性。

有关实现 OnPropertyValueChanged 方法的 代码示例，请参阅设备事件。