Compartilhar via


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

O método GetMasterVolumeLevel obtém o nível de volume master, em decibéis, do fluxo de áudio que entra ou sai do dispositivo de ponto de extremidade de áudio.

Sintaxe

HRESULT GetMasterVolumeLevel(
  [out] float *pfLevelDB
);

Parâmetros

[out] pfLevelDB

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 em decibéis. Para obter o intervalo de níveis de volume obtidos desse método, chame o método IAudioEndpointVolume::GetVolumeRange .

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 pfLevelDB é NULL.

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

IAudioEndpointVolume::GetVolumeRange