Método IChannelAudioVolume::GetChannelVolume (audioclient.h)

O método GetChannelVolume recupera o nível de volume do canal especificado na sessão de áudio.

Sintaxe

HRESULT GetChannelVolume(
  [in]  UINT32 dwIndex,
  [out] float  *pfLevel
);

Parâmetros

[in] dwIndex

O número do canal. Se o formato de fluxo da sessão de áudio tiver N canais, os canais serão numerados de 0 a N– 1. Para obter o número de canais, chame o método IChannelAudioVolume::GetChannelCount .

[out] pfLevel

Ponteiro para uma variável float na qual o método grava o nível de volume do canal especificado. O nível de volume está 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 dwIndex é definido como um número de canal inválido.
E_POINTER
O parâmetro pfLevel é NULL.
AUDCLNT_E_DEVICE_INVALIDATED
O dispositivo de ponto de extremidade de áudio foi desconectado ou o hardware de áudio ou os recursos de hardware associados foram reconfigurados, desabilitados, removidos ou não estão disponíveis para uso.
AUDCLNT_E_SERVICE_NOT_RUNNING
O serviço de áudio do Windows não está em execução.

Comentários

Os clientes podem chamar o método IChannelAudioVolume::SetAllVolumes ou IChannelAudioVolume::SetChannelVolume para definir os níveis de volume por canal em uma sessão de áudio.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho audioclient.h

Confira também

IChannelAudioVolume Interface

IChannelAudioVolume::GetChannelCount

IChannelAudioVolume::SetAllVolumes

IChannelAudioVolume::SetChannelVolume