Método IAudioStreamVolume::GetAllVolumes (audioclient.h)
O método GetAllVolumes recupera os níveis de volume para todos os canais no fluxo 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 obter o número de canais, chame o método IAudioStreamVolume::GetChannelCount .
[out] pfVolumes
Ponteiro para uma matriz de níveis de volume para os canais no fluxo 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.
Retornar valor
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 dwCount não é igual ao número de canais no fluxo. |
|
O parâmetro pfVolumes é 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 indisponí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 IAudioStreamVolume::SetAllVolumes ou IAudioStreamVolume::SetChannelVolume para definir os níveis de volume por canal em um fluxo de áudio.
Requisitos
| Requisito | Valor |
|---|---|
| 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
IAudioStreamVolume::GetChannelCount