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

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

  • Статья

Метод OnIconPathChanged уведомляет клиента о том, что значок отображения для сеанса изменился.

Синтаксис

HRESULT OnIconPathChanged(
  [in] LPCWSTR NewIconPath,
  [in] LPCGUID EventContext
);

Параметры

[in] NewIconPath

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

[in] EventContext

Значение контекста события. Это то же значение, которое вызывающий объект передал в IAudioSessionControl::SetIconPath в вызове, изменив значок отображения для сеанса. Дополнительные сведения см. в подразделе "Примечания".

Возвращаемое значение

Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.

Комментарии

Диспетчер сеансов вызывает этот метод каждый раз, когда вызов метода IAudioSessionControl::SetIconPath изменяет значок отображения сеанса. Программа Sndvol использует значок отображения сеанса, чтобы пометить ползунок громкости для сеанса.

Параметр EventContext предоставляет клиенту средства для различения инициированного им изменения значка отображения и изменения, инициированного другим клиентом. При вызове метода IAudioSessionControl::SetIconPath клиент передает значение параметра EventContext , которое может распознать его реализация метода OnIconPathChanged .

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

Требования

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

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

IAudioSessionControl::SetIconPath

Интерфейс IAudioSessionEvents