Метод IAudioEndpointVolumeCallback::OnNotify (endpointvolume.h)
Метод OnNotify уведомляет клиента об изменении уровня громкости или выключения звука на устройстве конечной точки звука.
Синтаксис
HRESULT OnNotify(
[in] PAUDIO_VOLUME_NOTIFICATION_DATA pNotify
);
Параметры
[in] pNotify
Указатель на данные уведомления о томе. Этот параметр указывает на структуру типа AUDIO_VOLUME_NOTIFICATION_DATA.
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.
Комментарии
Параметр pNotify указывает на структуру, описывающую событие изменения тома, которое инициировало вызов OnNotify. Эта структура содержит GUID контекста события. Этот GUID позволяет клиенту различать инициированное им изменение тома (или отключение звука) от изменения, инициированного другим клиентом. При вызове метода IAudioEndpointVolume , который изменяет уровень громкости потока, клиент передает указатель на идентификатор GUID контекста события, который может распознать его реализация метода OnNotify . Структура, на которую указывает pNotify , содержит этот guid контекста. Если клиент, изменяющий уровень тома, предоставляет для указателя значение NULL указателя на GUID контекста события, значение GUID контекста события в структуре, на которую указывает pNotify , GUID_NULL.
Windows 7, пользовательский интерфейс тома системы, не указывает GUID_NULL при изменении тома в системе. Сторонние osd-приложения могут различать master изменения управления громкости, которые возникают в пользовательском интерфейсе тома системы, и другие изменения тома, например изменения встроенного обработчика управления громкости.
Пример кода, реализующий метод OnNotify , см. в разделе Endpoint Volume Controls.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2008 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | endpointvolume.h |
См. также раздел
AUDIO_VOLUME_NOTIFICATION_DATA