Función X3DAudioCalculate (x3daudio.h)

  • Artículo

Calcula la configuración de DSP con respecto a los parámetros 3D.

Sintaxis

X3DAUDIO_API_(void) X3DAudioCalculate(
  [in]      const X3DAUDIO_HANDLE   Instance,
  [in]      const X3DAUDIO_LISTENER *pListener,
  [in]      const X3DAUDIO_EMITTER  *pEmitter,
  [in]      UINT32                  Flags,
  [in, out] X3DAUDIO_DSP_SETTINGS   *pDSPSettings
);

Parámetros

[in] Instance

Identificador de instancia de audio 3D. Llame a X3DAudioInitialize para obtener este identificador.

[in] pListener

Puntero a un X3DAUDIO_LISTENER que representa el punto de recepción.

[in] pEmitter

Puntero a un X3DAUDIO_EMITTER que representa la fuente de sonido.

[in] Flags

Valor Descripción
X3DAUDIO_CALCULATE_MATRIX Habilita el cálculo de la tabla de coeficientes de matriz. 
X3DAUDIO_CALCULATE_DELAY Habilita el cálculo de matriz de tiempo de retraso (solo estéreo). 
X3DAUDIO_CALCULATE_LPF_DIRECT Habilita el cálculo del coeficiente de ruta directa de filtro de paso bajo (LPF). 
X3DAUDIO_CALCULATE_LPF_REVERB Habilita el cálculo del coeficiente de la ruta de acceso de reverberación LPF. 
X3DAUDIO_CALCULATE_REVERB Habilita el cálculo del nivel de envío de reverberación. 
X3DAUDIO_CALCULATE_DOPPLER Habilita el cálculo de factor de desplazamiento de Shift. 
X3DAUDIO_CALCULATE_EMITTER_ANGLE Habilita el cálculo del ángulo interior del emisor al cliente de escucha. 
X3DAUDIO_CALCULATE_ZEROCENTER Llena el canal central con silencio. Esta marca le permite mantener una matriz de 6 canales para que no tenga que reasignar los canales, pero el canal central será silencioso. Esta marca solo es válida si también establece X3DAUDIO_CALCULATE_MATRIX. 
X3DAUDIO_CALCULATE_REDIRECT_TO_LFE Aplica una combinación igual de todos los canales de origen a un canal de destino de efecto de baja frecuencia (LFE). Solo se aplica a los cálculos de matriz con un origen que no tiene un canal LFE y un destino que tiene un canal LFE. Esta marca solo es válida si también establece X3DAUDIO_CALCULATE_MATRIX. 

[in, out] pDSPSettings

Puntero a una estructura de X3DAUDIO_DSP_SETTINGS que recibe los resultados del cálculo.

Valor devuelto

Esta función no devuelve ningún valor.

Observaciones

Normalmente, se llama a X3DAudioCalculate una vez para cada par de emisores de objetos y agentes de escucha en la escena. Después de cada llamada, para aplicar los efectos 3D, la aplicación aplica manualmente los resultados de cálculo en pDSPSettings al gráfico de XAUDIO2. Para obtener más información, consulta Cómo: Integrar X3DAudio con XAudio2.

Importante Los valores de agente de escucha y emisor deben ser válidos. Las especialidades de punto flotante (NaN, QNaN, +INF, -INF) pueden hacer que toda la salida de audio se muera si se introduce en un gráfico de audio en ejecución.
 

Requisitos de la plataforma

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

Windows Phone 8.1: se admite esta API.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado x3daudio.h
Library Xaudio2.lib

Vea también

Funciones