Método IAudioEndpointVolume::GetChannelVolumeLevel (endpointvolume.h)
O método GetChannelVolumeLevel obtém o nível de volume, em decibéis, do canal especificado no fluxo de áudio que entra ou sai do dispositivo de ponto de extremidade de áudio.
Sintaxe
HRESULT GetChannelVolumeLevel(
[in] UINT nChannel,
[out] float *pfLevelDB
);
Parâmetros
[in] nChannel
O número do canal. Se o fluxo de áudio tiver n canais, os canais serão numerados de 0 a n– 1. Para obter o número de canais no fluxo, chame o método IAudioEndpointVolume::GetChannelCount .
[out] pfLevelDB
Ponteiro 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 .
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 |
---|---|
|
O parâmetro nChannel é maior ou igual ao número de canais no fluxo. |
|
O parâmetro pfLevelDB é NULL. |
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