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

  • Artículo

Establece el nivel de volumen general de la voz.

Sintaxis

\\HRESULT SetVolume(
  [in] float  Volume,
  [in] UINT32 OperationSet
);

Parámetros

[in] Volume

Nivel de volumen general que se va a usar. 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 de XAudio2 para obtener descripciones de los códigos de error.

Comentarios

SetVolume controla el nivel de volumen de entrada maestra de una voz. El nivel de volumen maestro se aplica en momentos diferentes según el tipo de voz. En el caso de las voces de submezcla y maestro, el nivel de volumen se aplica justo antes de que se aplique la cadena de filtros y efectos integrada de la voz. En el caso de las voces de origen, el nivel de volumen maestro se aplica después de aplicar el filtro y la cadena de efectos de la voz.

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 nivel de volumen de 1,0 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.

NotaIXAudio2Voice::GetVolume siempre devuelve el volumen establecido más recientemente por IXAudio2Voice::SetVolume. Sin embargo, es posible que aún no esté en vigor: solo surte efecto la próxima vez que se ejecute el motor de audio después de la llamada IXAudio2Voice::SetVolume (o después de la llamada IXAudio2::CommitChanges correspondiente, si se llamó a IXAudio2Voice::SetVolume con un identificador de operación diferida).
 

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

Cómo: usar voces de submezcla

IXAudio2Voice