Compartir a través de

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

  • Artículo

Obtiene el nivel de volumen de cada canal de la salida final de la voz. Estos canales se asignan a los canales de entrada de una voz de destino especificada.

Sintaxis

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

Parámetros

[in] pDestinationVoice

Puntero que especifica el destino IXAudio2Voice para recuperar la matriz de salida.

Nota Si la voz envía a una sola voz de destino, si especifica NULL, GetOutputMatrix funcionará en esa voz de destino.
 

[in] SourceChannels

Confirma el recuento de canales de salida de la voz. Este es el número de canales producidos por el último efecto de la cadena.

[in] DestinationChannels

Confirma el recuento de canales de entrada de la voz de destino.

[out] pLevelMatrix

Matriz de niveles de volumen [SourceChannels * DestinationChannels] enviados a la voz de destino. El nivel enviado desde el canal de origen S al canal de destino D se devuelve con el formato pLevelMatrix[DestinationChannels × S + D]. Vea Comentarios para obtener más información sobre los niveles de volumen.

Valor devuelto

Este método no devuelve ningún valor.

Comentarios

Este método solo se aplica a las voces de origen y submezcla, ya que las voces de maestro escriben directamente en el dispositivo sin mezclar matrices.

Los niveles de volumen se expresan como multiplicadores de amplitud de punto flotante entre -2²⁴ a 2²⁴, con una ganancia máxima de 144,5 dB. Un nivel de volumen de 1 significa que no hay atenuación o ganancia y 0 significa silencio. Los niveles negativos se pueden usar para invertir la fase del audio. Consulte Control de volumen y inclinación de XAudio2 para obtener información adicional sobre el control de volumen.

Consulte WAVEFORMATEXTENSIBLE para obtener información sobre el orden de canales estándar.

NotaGetOutputMatrix siempre devuelve los niveles establecidos más recientemente por IXAudio2Voice::SetOutputMatrix. Sin embargo, es posible que aún no estén en vigor: solo surten efecto la próxima vez que se ejecute el motor de audio después de la llamada a IXAudio2Voice::SetOutputMatrix (o después de la llamada IXAudio2::CommitChanges correspondiente, si se llamó a IXAudio2Voice::SetOutputMatrix con un identificador de operación diferido).
 

Requisitos de la plataforma

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

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado xaudio2.h

Consulte también

IXAudio2Voice