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

O método GetAllVolumes recupera os níveis de volume para todos os canais na sessão de áudio.

Sintaxe

HRESULT GetAllVolumes(
  [in]  UINT32 dwCount,
  [out] float  *pfVolumes
);

Parâmetros

[in] dwCount

O número de elementos na matriz pfVolumes . O parâmetro dwCount deve ser igual ao número de canais no formato de fluxo para a sessão de áudio. Para obter o número de canais, chame o método IChannelAudioVolume::GetChannelCount .

[out] pfVolumes

Ponteiro para uma matriz de níveis de volume para os canais na sessão de áudio. Esse parâmetro aponta para uma matriz float alocada pelo chamador na qual o método grava os níveis de volume para os canais individuais. Os níveis de volume estão 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 dwCount não é igual ao número de canais no formato de fluxo para a sessão de áudio.
E_POINTER	O parâmetro pfVolumes é 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 indisponí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