Método IAudioStreamVolume::SetAllVolumes (audioclient.h)

O método SetAllVolumes define os níveis de volume individuais para todos os canais no fluxo de áudio.

Sintaxe

HRESULT SetAllVolumes(
  [in] UINT32      dwCount,
  [in] const float *pfVolumes
);

Parâmetros

[in] dwCount

O número de elementos na matriz pfVolumes . Esse parâmetro 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 .

[in] pfVolumes

Ponteiro para uma matriz de níveis de volume para os canais no fluxo de áudio. O número de elementos na matriz pfVolumes é especificado pelo parâmetro dwCount . O chamador grava o nível de volume de cada canal no elemento de matriz cujo índice corresponde ao número do canal. Se o formato de fluxo tiver N canais, os canais serão numerados de 0 a N– 1. Os níveis de volume válidos 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
E_INVALIDARG	O parâmetro dwCount não é igual ao número de canais no fluxo ou o valor de um elemento de matriz pfVolumes não está no intervalo de 0,0 a 1,0.
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 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.

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 Interface

IAudioStreamVolume::GetChannelCount