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

  • Artículo

Devuelve los niveles de volumen de la voz, por canal.

Sintaxis

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

Parámetros

[in] Channels

Confirma el recuento de canales de la voz.

[out] pVolumes

Devuelve el nivel de volumen actual de cada canal de la voz. La matriz debe tener al menos elementos Channels . Vea Comentarios para obtener más información sobre los niveles de volumen.

Valor devuelto

Este método no devuelve ningún valor.

Comentarios

Esta configuración se aplica después de aplicar la cadena de efectos. Este método solo es válido para las voces de origen y submezcla, ya que las voces de maestro no especifican el volumen por canal.

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 volumen de 1 significa que no hay atenuación ni ganancia, 0 significa silencio, y los niveles negativos se pueden usar para invertir la fase del audio. Consulte Control de volumen y tono XAudio2 para obtener información adicional sobre el control de volumen.

NotaGetChannelVolumes siempre devuelve los niveles de volumen establecidos más recientemente por IXAudio2Voice::SetChannelVolumes. Sin embargo, es posible que esos valores no estén realmente en vigor todavía: solo surten efecto la próxima vez que se ejecute el motor de audio después de la llamada IXAudio2Voice::SetChannelVolumes (o después de la llamada IXAudio2::CommitChanges , si IXAudio2Voice::SetChannelVolumes se llamó 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