Método IAudioMeterInformation::GetPeakValue (endpointvolume.h)

El método GetPeakValue obtiene el valor máximo de muestra para los canales de la secuencia de audio.

Sintaxis

HRESULT GetPeakValue(
  [out] float *pfPeak
);

Parámetros

[out] pfPeak

Puntero a una variable float en la que el método escribe el valor de ejemplo máximo para la secuencia de audio. El valor máximo es un número del intervalo normalizado de 0,0 a 1,0.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los códigos de retorno posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.

Código devuelto Descripción
E_POINTER
El parámetro pfPeak es NULL.

Comentarios

Este método recupera el valor máximo de ejemplo registrado en todos los canales de la secuencia. El valor máximo de cada canal se registra durante un período de dispositivo y está disponible durante el período de dispositivo posterior. Por lo tanto, este método siempre recupera el valor máximo registrado durante el período de dispositivo anterior. Para obtener el período del dispositivo, llame al método IAudioClient::GetDevicePeriod .

Para obtener un ejemplo de código que usa el método GetPeakValue , vea Peak Meters.

Requisitos

   
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado endpointvolume.h

Consulte también

IAudioClient::GetDevicePeriod

IAudioMeterInformation (interfaz)