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

Интерфейс IAudioSessionManager позволяет клиенту получать доступ к элементам управления сеансом и громкости для аудиосеансов между процессами и процессами. Клиент получает ссылку на интерфейс IAudioSessionManager , вызывая метод IMMDevice::Activate с параметром iid , равным REFIID IID_IAudioSessionManager.

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

В Windows Vista интерфейсы API более высокого уровня, использующие WASAPI, включают Media Foundation, DirectSound, windows multimedia waveInXxx, waveOutXxx и mciXxx , а также сторонние API.

Когда клиент создает аудиопоток через API более высокого уровня, этот API обычно добавляет поток в звуковой сеанс по умолчанию для клиентского процесса (сеанс, который определяется значением GUID сеанса, GUID_NULL), но тот же API может не предоставлять клиенту средства доступа к элементам управления для этого сеанса. В этом случае клиент может получить доступ к элементам управления через интерфейс IAudioSessionManager .

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

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

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

Методы

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

IAudioSessionManager::GetAudioSessionControl Метод GetAudioSessionControl извлекает элемент управления аудиосеанса.
IAudioSessionManager::GetSimpleAudioVolume Метод GetSimpleAudioVolume извлекает простой элемент управления громкостью звука.

Требования

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

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

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

IMMDevice::Activate

WASAPI