Compartilhar via

Método IXAudio2Voice::GetChannelVolumes (xaudio2.h)

  • Artigo

Retorna os níveis de volume para a voz, por canal.

Sintaxe

\\ void GetChannelVolumes(
  [in]  UINT32 Channels,
  [out] float  *pVolumes
);

Parâmetros

[in] Channels

Confirma a contagem de canais da voz.

[out] pVolumes

Retorna o nível de volume atual de cada canal na voz. A matriz deve ter pelo menos elementos Channels . Consulte Comentários para obter mais informações sobre níveis de volume.

Retornar valor

Esse método não retorna um valor.

Comentários

Essas configurações são aplicadas depois que a cadeia de efeitos é aplicada. Esse método é válido apenas para vozes de origem e submixagem, pois as vozes de masterização não especificam volume por canal.

Os níveis de volume são expressos como multiplicadores de amplitude de ponto flutuante entre -2²⁴ a 2²⁴, com um ganho máximo de 144,5 dB. Um volume de 1 significa que não há atenuação ou ganho, 0 significa silêncio e níveis negativos podem ser usados para inverter a fase do áudio. Consulte Volume XAudio2 e Controle de Tom para obter informações adicionais sobre o controle de volume.

ObservaçãoGetChannelVolumes sempre retorna os níveis de volume definidos mais recentemente por IXAudio2Voice::SetChannelVolumes. No entanto, esses valores podem ainda não estar em vigor: eles só entrarão em vigor na próxima vez que o mecanismo de áudio for executado após a chamada de IXAudio2Voice::SetChannelVolumes (ou após a chamada IXAudio2::CommitChanges correspondente, se IXAudio2Voice::SetChannelVolumes tiver sido chamado com uma ID de operação adiada).
 

Requisitos de plataforma

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); SDK do DirectX (XAudio 2.7)

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho xaudio2.h

Confira também

IXAudio2Voice