Compartilhar via

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

  • Artigo

Obtém o nível de volume de cada canal da saída final para a voz. Esses canais são mapeados para os canais de entrada de uma voz de destino especificada.

Sintaxe

\\ void GetOutputMatrix(
  [in]  IXAudio2Voice *pDestinationVoice,
  [in]  UINT32        SourceChannels,
  [in]  UINT32        DestinationChannels,
  [out] float         *pLevelMatrix
);

Parâmetros

[in] pDestinationVoice

Ponteiro que especifica o IXAudio2Voice de destino para o qual recuperar a matriz de saída.

Nota Se a voz for enviada para uma única voz de destino, especificar NULL fará com que GetOutputMatrix opere nessa voz de destino.
 

[in] SourceChannels

Confirma a contagem de canais de saída da voz. Esse é o número de canais produzidos pelo último efeito na cadeia.

[in] DestinationChannels

Confirma a contagem de canais de entrada da voz de destino.

[out] pLevelMatrix

Matriz de níveis de volume [SourceChannels * DestinationChannels] enviados para a voz de destino. O nível enviado do canal de origem S para o canal de destino D é retornado no formato pLevelMatrix[DestinationChannels × S + D]. 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

Esse método se aplica somente a vozes de origem e submixagem, pois as vozes de mestre gravam diretamente no dispositivo sem combinação de matriz.

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 nível de 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 XAudio2 Volume and Pitch Control para obter informações adicionais sobre o controle de volume.

Consulte WAVEFORMATEXTENSIBLE para obter informações sobre a ordenação de canal padrão.

ObservaçãoGetOutputMatrix sempre retorna os níveis mais recentemente definidos por IXAudio2Voice::SetOutputMatrix. No entanto, eles 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 IXAudio2Voice::SetOutputMatrix (ou após a chamada IXAudio2::CommitChanges correspondente, se IXAudio2Voice::SetOutputMatrix foi chamado com uma ID de operação adiada).
 

Requisitos da 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