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

  • Artículo

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

Sintaxis

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

Parámetros

[in] Channels

Número de canales en la voz.

[in] pVolumes

Matriz que contiene los nuevos volúmenes de cada canal en la voz. La matriz debe tener elementos Channels . Vea Comentarios para obtener más información sobre los niveles de volumen.

[in] OperationSet

Identifica esta llamada como parte de un lote diferido. Consulte la información general sobre conjuntos de operaciones XAudio2 para obtener más información.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente, de lo contrario, un código de error. Consulte Códigos de error XAudio2 para obtener descripciones de códigos de error específicos de XAudio2.

Comentarios

SetChannelVolumes controla los niveles de salida por canal de una voz y se aplica justo después del SRC final de la voz y antes de sus envíos.

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 -XAUDIO2_MAX_VOLUME_LEVEL y XAUDIO2_MAX_VOLUME_LEVEL (-2²⁴ a 2²⁴), con una ganancia máxima de 144,5 dB. Un volumen de 1 significa que no hay atenuación ni 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.

NotaIXAudio2Voice::GetChannelVolumes siempre devuelve los niveles de volumen establecidos más recientemente por IXAudio2Voice::SetChannelVolumes. Sin embargo, esos valores pueden no estar 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 correspondiente, si se llamó a IXAudio2Voice::SetChannelVolumes 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

Cómo: Cambiar el volumen de voz

IXAudio2Voice