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 |
|---|---|
|
O parâmetro dwIndex é definido como um número de canal inválido. |
|
O parâmetro pfLevel é NULL. |
|
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. |
|
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::GetChannelCount