Método IAudioMeterInformation::GetChannelsPeakValues (endpointvolume.h)
O método GetChannelsPeakValues obtém os valores de exemplo de pico para todos os canais no fluxo de áudio.
Sintaxe
HRESULT GetChannelsPeakValues(
[in] UINT32 u32ChannelCount,
[out] float *afPeakValues
);
Parâmetros
[in] u32ChannelCount
A contagem de canais. Esse parâmetro também especifica o número de elementos na matriz afPeakValues . Se a contagem especificada não corresponder ao número de canais no fluxo, o método retornará o código de erro E_INVALIDARG.
[out] afPeakValues
Ponteiro para uma matriz de valores de exemplo de pico. O método grava os valores de pico para os canais na matriz. A matriz contém um elemento para cada canal no fluxo. Os valores de pico são números no intervalo normalizado de 0,0 a 1,0.
Retornar valor
Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.
| Código de retorno | Descrição |
|---|---|
|
O parâmetro u32ChannelCount não é igual ao número de canais no fluxo de áudio. |
|
O parâmetro afPeakValues é NULL. |
Comentários
Esse método recupera os valores de exemplo de pico para os canais no fluxo. O valor de pico para cada canal é registrado durante um período de dispositivo e disponibilizado durante o período subsequente do dispositivo. Portanto, esse método sempre recupera os valores de pico registrados durante o período anterior do dispositivo. Para obter o período do dispositivo, chame o método IAudioClient::GetDevicePeriod .
O parâmetro afPeakValues aponta para uma matriz float alocada pelo chamador . Se o fluxo contiver n canais, os canais serão numerados de 0 a n– 1. O método armazena o valor de pico para cada canal no elemento de matriz cujo índice de matriz corresponde ao número do canal. Para obter o número de canais no fluxo de áudio que são monitorados por medidores de pico, chame o método IAudioMeterInformation::GetMeteringChannelCount .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | endpointvolume.h |