Метод IAudioSessionEvents::OnDisplayNameChanged (audiopolicy.h)

Статья
08/22/2023

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

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

IAudioSessionControl::SetDisplayName

Интерфейс IAudioSessionEvents

Share via