Compartilhar via


Método IAudioEndpointVolume::GetChannelVolumeLevelScalar (endpointvolume.h)

O método GetChannelVolumeLevelScalar obtém o nível de volume normalizado e gravado em áudio do canal especificado do fluxo de áudio que entra ou sai do dispositivo de ponto de extremidade de áudio.

Sintaxe

HRESULT GetChannelVolumeLevelScalar(
  [in]  UINT  nChannel,
  [out] float *pfLevel
);

Parâmetros

[in] nChannel

O número do canal. Se o fluxo de áudio contiver n canais, os canais serão numerados de 0 a n– 1. Para obter o número de canais, chame o método IAudioEndpointVolume::GetChannelCount .

[out] pfLevel

Ponteiro para uma variável float na qual o método grava o nível de volume. O nível é expresso como um valor normalizado no intervalo 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_INVALIDARG
O parâmetro nChannel é maior ou igual ao número de canais no fluxo.
E_POINTER
O parâmetro pfLevel é NULL.

Comentários

O nível de volume é normalizado para o intervalo de 0,0 a 1,0, em que 0,0 é o nível mínimo de volume e 1,0 é o nível máximo. Dentro desse intervalo, a relação do nível de volume normalizado com a atenuação da amplitude do sinal é descrita por uma curva não linear e com áudio afilado. Observe que a forma da curva pode mudar em versões futuras do Windows. Para obter mais informações sobre curvas de áudio afilado, consulte Audio-Tapered Volume Controls.

Os níveis de volume normalizados recuperados por esse método são adequados para representar as posições dos controles de volume nas janelas do aplicativo e nas telas na tela.

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

IAudioEndpointVolume Interface

IAudioEndpointVolume::GetChannelCount