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


Интерфейс IAudioSessionControl (audiopolicy.h)

Интерфейс IAudioSessionControl позволяет клиенту настраивать параметры управления для звукового сеанса и отслеживать события в сеансе. Метод IAudioClient::Initialize инициализирует объект потока и назначает поток звуковому сеансу. Клиент получает ссылку на интерфейс IAudioSessionControl в объекте потока, вызывая метод IAudioClient::GetService с параметром riid , равным REFIID IID_IAudioSessionControl.

Кроме того, клиент может получить интерфейс IAudioSessionControl существующего сеанса, не создавая сначала объект потока и добавляя поток в сеанс. Вместо этого клиент вызывает метод IAudioSessionManager::GetAudioSessionControl с параметром AudioSessionGuid , заданным для GUID сеанса.

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

При освобождении экземпляра интерфейса IAudioSessionControl клиент должен вызвать метод Release интерфейса из того же потока, что и вызов IAudioClient::GetService , создавшего объект .

Интерфейс IAudioSessionControl управляет звуковым сеансом. Аудиосеанс — это коллекция потоков общего режима. Этот интерфейс не работает с потоками в монопольном режиме.

Пример кода, в котором используется интерфейс IAudioSessionControl , см. в разделе Звуковые события для устаревших звуковых приложений.

Наследование

Интерфейс IAudioSessionControl наследуется от интерфейса IUnknown . IAudioSessionControl также имеет следующие типы элементов:

Методы

Интерфейс IAudioSessionControl содержит следующие методы.

 
IAudioSessionControl::GetDisplayName

Метод GetDisplayName извлекает отображаемое имя звукового сеанса.
IAudioSessionControl::GetGroupingParam

Метод GetGroupingParam извлекает параметр группировки звукового сеанса.
IAudioSessionControl::GetIconPath

Метод GetIconPath извлекает путь к значку отображения для звукового сеанса.
IAudioSessionControl::GetState

Метод GetState извлекает текущее состояние звукового сеанса.
IAudioSessionControl::RegisterAudioSessionNotification

Метод RegisterAudioSessionNotification регистрирует клиент для получения уведомлений о событиях сеанса, включая изменения в состоянии потока.
IAudioSessionControl::SetDisplayName

Метод SetDisplayName назначает отображаемое имя текущему сеансу.
IAudioSessionControl::SetGroupingParam

Метод SetGroupingParam назначает сеанс группе сеансов.
IAudioSessionControl::SetIconPath

Метод SetIconPath назначает значок отображения текущему сеансу.
IAudioSessionControl::UnregisterAudioSessionNotification

Метод UnregisterAudioSessionNotification удаляет предыдущую регистрацию клиента для получения уведомлений.

Требования

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

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

Основные звуковые интерфейсы

IAudioClient::GetService

IAudioClient::Initialize

IAudioSessionManager::GetAudioSessionControl

WASAPI