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