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

Метод IAudioMeterInformation::GetPeakValue (endpointvolume.h)

  • Статья

Метод GetPeakValue получает пиковое значение примера для каналов в аудиопотоке.

Синтаксис

HRESULT GetPeakValue(
  [out] float *pfPeak
);

Параметры

[out] pfPeak

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

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

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

Код возврата Описание
E_POINTER
 Параметр pfPeak имеет значение NULL.

Комментарии

Этот метод извлекает пиковое значение выборки, записанное по всем каналам в потоке. Пиковое значение для каждого канала записывается в течение одного периода устройства и становится доступным в течение последующего периода устройства. Таким образом, этот метод всегда получает пиковое значение, записанное за предыдущий период устройства. Чтобы получить период устройства, вызовите метод IAudioClient::GetDevicePeriod .

Пример кода, в котором используется метод GetPeakValue , см. в разделе Peak Meter.

Требования

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

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

IAudioClient::GetDevicePeriod

Интерфейс IAudioMeterInformation