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

O método GetMasterVolumeLevelScalar obtém o master nível de volume do fluxo de áudio que entra ou sai do dispositivo de ponto de extremidade de áudio. O nível de volume é expresso como um valor normalizado e gravado em áudio no intervalo de 0,0 a 1,0.

Sintaxe

HRESULT GetMasterVolumeLevelScalar(
  [out] float *pfLevel
);

Parâmetros

[out] pfLevel

Ponteiro para o nível de volume master. Esse parâmetro aponta 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.

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

Comentários

O nível de volume é normalizado para o intervalo de 0,0 a 1,0, onde 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 afilada de áudio não linear. Observe que a forma da curva pode mudar em versões futuras do Windows. Para obter mais informações sobre curvas afilados em áudio, consulte Controles de volume em fita de áudio.

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.

Para obter um exemplo de código que chama GetMasterVolumeLevelScalar, consulte Controles de volume do ponto de extremidade.

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

Confira também

IAudioEndpointVolume Interface