Метод IAudioSessionEvents::OnDisplayNameChanged (audiopolicy.h)
Метод OnDisplayNameChanged уведомляет клиента об изменении отображаемого имени сеанса.
Синтаксис
HRESULT OnDisplayNameChanged(
[in] LPCWSTR NewDisplayName,
[in] LPCGUID EventContext
);
Параметры
[in] NewDisplayName
Новое отображаемое имя сеанса. Этот параметр указывает на строку расширенных символов, завершающуюся null, которая содержит новое отображаемое имя. Строка остается действительной в течение всего вызова.
[in] EventContext
Значение контекста события. Это то же значение, которое вызывающий объект передал в IAudioSessionControl::SetDisplayName в вызове, изменив отображаемое имя сеанса. Дополнительные сведения см. в подразделе "Примечания".
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.
Комментарии
Диспетчер сеансов вызывает этот метод каждый раз, когда вызов метода IAudioSessionControl::SetDisplayName изменяет отображаемое имя сеанса. Программа Sndvol использует отображаемое имя сеанса, чтобы пометить ползунок громкости для сеанса.
Параметр EventContext предоставляет клиенту средства, позволяющие различать инициированное им отображаемое имя и инициированное другим клиентом изменение. При вызове метода IAudioSessionControl::SetDisplayName клиент передает значение параметра EventContext , которое может распознать его реализация метода OnDisplayNameChanged .
Пример кода, реализующий методы в интерфейсе IAudioSessionEvents , см. в разделе События аудиосеанса.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2008 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | audiopolicy.h |