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

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

  • Статья

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

Синтаксис

HRESULT GetSimpleAudioVolume(
  [in]  LPCGUID            AudioSessionGuid,
  [in]  DWORD              StreamFlags,
  [out] ISimpleAudioVolume **AudioVolume
);

Параметры

[in] AudioSessionGuid

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

[in] StreamFlags

Указывает, предназначен ли запрос для сеанса между процессами. Установите значение TRUE , если сеанс является межпроцессным. Установите значение FALSE , если сеанс не является межпроцессным.

[out] AudioVolume

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

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

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

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

Требования

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

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

Интерфейс IAudioSessionManager

Интерфейс ISimpleAudioVolume