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

Artigo
08/23/2023

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
E_INVALIDARG	O parâmetro nChannel é maior ou igual ao número de canais no fluxo.
E_POINTER	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

IAudioEndpointVolume::GetChannelCount

IAudioEndpointVolume::GetVolumeRange

Share via