Función X3DAudioCalculate (x3daudio.h)
Calcula la configuración de DSP con respecto a los parámetros 3D.
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
);
[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.
Esta función no devuelve ningún valor.
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.
Windows Phone 8.1: se admite esta API.
Requisito | Value |
---|---|
Plataforma de destino | Windows |
Encabezado | x3daudio.h |
Library | Xaudio2.lib |