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

El método GetChannelsPeakValues obtiene los valores de ejemplo máximos de todos los canales de la secuencia de audio.

Sintaxis

HRESULT GetChannelsPeakValues(
  [in]  UINT32 u32ChannelCount,
  [out] float  *afPeakValues
);

Parámetros

[in] u32ChannelCount

Recuento de canales. Este parámetro también especifica el número de elementos de la matriz afPeakValues . Si el recuento especificado no coincide con el número de canales de la secuencia, el método devuelve el código de error E_INVALIDARG.

[out] afPeakValues

Puntero a una matriz de valores de ejemplo máximos. El método escribe los valores máximos de los canales en la matriz. La matriz contiene un elemento para cada canal de la secuencia. Los valores máximos son números 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 posibles códigos de retorno incluyen, pero no están limitados a, los valores que se muestran en la tabla siguiente.

Código devuelto	Descripción
E_INVALIDARG	El parámetro u32ChannelCount no es igual al número de canales de la secuencia de audio.
E_POINTER	El parámetro afPeakValues es NULL.

Comentarios

Este método recupera los valores de ejemplo máximos de 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 los valores máximos registrados durante el período anterior del dispositivo. Para obtener el período del dispositivo, llame al método IAudioClient::GetDevicePeriod .

El parámetro afPeakValues apunta a una matriz float asignada por el autor de la llamada. Si la secuencia contiene n canales, los canales se numeran de 0 a n– 1. El método almacena el valor máximo de cada canal del elemento de matriz cuyo índice de matriz coincide con el número de canal. Para obtener el número de canales en la secuencia de audio supervisada por medidores de pico, llame al método IAudioMeterInformation::GetMeteringChannelCount .

Requisitos

Requisito	Value
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)

IAudioMeterInformation::GetMeteringChannelCount