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

Метод ISimpleAudioVolume::GetMasterVolume (audioclient.h)

  • Статья

Метод GetMasterVolume извлекает уровень громкости клиента для звукового сеанса.

Синтаксис

HRESULT GetMasterVolume(
  [out] float *pfLevel
);

Параметры

[out] pfLevel

Указатель на переменную с плавающей точкой , в которую метод записывает уровень тома клиента. Уровень тома — это значение в диапазоне от 0,0 до 1,0.

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

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

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

Комментарии

Этот метод извлекает уровень тома клиента для сеанса. Это уровень громкости, заданный клиентом при предыдущем вызове метода ISimpleAudioVolume::SetMasterVolume .

Требования

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

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

IAudioClient::Initialize

Интерфейс ISimpleAudioVolume

ISimpleAudioVolume::SetMasterVolume