Метод 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. В случае сбоя возможные коды возврата включают, помимо прочего, значения, показанные в следующей таблице.
Код возврата | Описание |
---|---|
|
Аудиопоток не инициализирован. |
|
Устройство конечной точки аудио отключено, звуковое оборудование или связанные аппаратные ресурсы были перенастроены, отключены, удалены или иным образом недоступны для использования. |
|
Служба звука Windows не запущена. |
|
Параметр AudioVolume имеет значение NULL. |
|
Недостаточно памяти. |
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows Vista [только классические приложения] |
Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
Целевая платформа | Windows |
Header | audiopolicy.h |