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

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

  • Статья

Метод 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