Интерфейс 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 |