Поделиться через

Метод 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.

Клиент может использовать параметр ключа для получения нового значения свойства. Пример кода, в котором ключ свойства используется для получения значения свойства из хранилища свойств устройства конечной точки, см. в разделе Свойства устройства.

Пример кода, реализующий метод OnPropertyValueChanged , см. в разделе События устройства.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header mmdeviceapi.h

См. также раздел

Интерфейс IMMNotificationClient