Compartilhar via

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

  • Artigo

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

Sintaxe

\\HRESULT SetChannelVolumes(
  [in] UINT32      Channels,
  [in] const float *pVolumes,
  [in] UINT32      OperationSet
);

Parâmetros

[in] Channels

Número de canais na voz.

[in] pVolumes

Matriz que contém os novos volumes de cada canal na voz. A matriz deve ter elementos Channels . Consulte Comentários para obter mais informações sobre níveis de volume.

[in] OperationSet

Identifica essa chamada como parte de um lote adiado. Consulte a Visão geral dos Conjuntos de Operações XAudio2 para obter mais informações.

Retornar valor

Retorna S_OK se tiver êxito, caso contrário, um código de erro. Consulte Códigos de erro XAudio2 para obter descrições de códigos de erro específicos do XAudio2.

Comentários

SetChannelVolumes controla os níveis de saída por canal de uma voz e é aplicado logo após o SRC final da voz e antes de seus envios.

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 -XAUDIO2_MAX_VOLUME_LEVEL e XAUDIO2_MAX_VOLUME_LEVEL (-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 e 0 significa silêncio. 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çãoIXAudio2Voice::GetChannelVolumes 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

Como alterar o volume de voz

IXAudio2Voice