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

O método GetPeakValue obtém o valor de exemplo de pico para os canais no fluxo de áudio.

Sintaxe

HRESULT GetPeakValue(
  [out] float *pfPeak
);

Parâmetros

[out] pfPeak

Ponteiro para uma variável float na qual o método grava o valor de exemplo de pico para o fluxo de áudio. O valor de pico é um número no intervalo normalizado de 0,0 a 1,0.

Valor retornado

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
E_POINTER	O parâmetro pfPeak é NULL.

Comentários

Esse método recupera o valor de exemplo de pico registrado em todos os canais no fluxo. O valor de pico para cada canal é registrado durante um período de dispositivo e disponibilizado durante o período de dispositivo subsequente. Assim, esse método sempre recupera o valor de pico registrado durante o período anterior do dispositivo. Para obter o período do dispositivo, chame o método IAudioClient::GetDevicePeriod .

Para obter um exemplo de código que usa o método GetPeakValue , consulte Medidores de Pico.

Requisitos

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

Confira também

IAudioClient::GetDevicePeriod

IAudioMeterInformation Interface