Метод IAudioSessionManager::GetAudioSessionControl (audiopolicy.h)

Статья
08/22/2023

Метод GetAudioSessionControl извлекает элемент управления аудиосеанса.

Синтаксис

HRESULT GetAudioSessionControl(
  [in]  LPCGUID              AudioSessionGuid,
  [in]  DWORD                StreamFlags,
  [out] IAudioSessionControl **SessionControl
);

Параметры

[in] AudioSessionGuid

Указатель на GUID сеанса. Если GUID не идентифицирует ранее открытый сеанс, вызов открывает новый, но пустой сеанс. Программа Sndvol не отображает элемент управления уровня тома для сеанса, если он не содержит один или несколько активных потоков. Если этот параметр имеет значение NULL или указывает на значение GUID_NULL, метод назначает поток сеансу по умолчанию.

[in] StreamFlags

Указывает состояние флагов для аудиопотока.

[out] SessionControl

Указатель на переменную указателя, в которую метод записывает указатель на интерфейс IAudioSessionControl объекта управления аудиосеансом. Вызывающий объект отвечает за освобождение интерфейса, когда он больше не нужен, путем вызова метода Release интерфейса. Если вызов завершается сбоем, *SessionControl имеет значение NULL.

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

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

Код возврата	Описание
AUDCLNT_E_NOT_INITIALIZED	Аудиопоток не инициализирован.
AUDCLNT_E_DEVICE_INVALIDATED	Устройство конечной точки звука было отключено, или звуковое оборудование или связанные аппаратные ресурсы были перенастроены, отключены, удалены или иным образом стали недоступными для использования.
AUDCLNT_E_SERVICE_NOT_RUNNING	Аудиослужба Windows не запущена.
E_POINTER	Параметр SessionControl имеет значение NULL.
E_MEMORY	Недостаточно памяти.

Требования


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

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

Интерфейс IAudioSessionControl

Интерфейс IAudioSessionManager

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