Compartir a través de


estructura KSDS3D_HRTF_INIT_MSG (ksmedia.h)

La estructura KSDS3D_HRTF_INIT_MSG especifica la configuración de parámetros que se va a usar para inicializar la función de transferencia relativa al encabezado (HRTF).

Sintaxis

typedef struct {
  ULONG                      Size;
  KSDS3D_HRTF_FILTER_QUALITY Quality;
  FLOAT                      SampleRate;
  ULONG                      MaxFilterSize;
  ULONG                      FilterTransientMuteLength;
  ULONG                      FilterOverlapBufferLength;
  ULONG                      OutputOverlapBufferLength;
  ULONG                      Reserved;
} KSDS3D_HRTF_INIT_MSG, *PKSDS3D_HRTF_INIT_MSG;

Miembros

Size

Especifica el tamaño en bytes de la estructura.

Quality

Especifica el nivel de calidad del filtro HRTF. Establezca este parámetro en uno de los siguientes valores de enumeración KSDS3D_HRTF_FILTER_QUALITY:

  • LIGHT_FILTER selecciona un algoritmo eficaz que produce un efecto de buena calidad.
  • FULL_FILTER selecciona un algoritmo que genera un efecto de alta calidad, pero requiere más tiempo de procesamiento.

SampleRate

Especifica la frecuencia de muestreo, en muestras por segundo (hercio), en la que se debe reproducir cada canal. Por ejemplo, un valor de 22 050 especifica una frecuencia de muestreo de 22,05 kHz.

MaxFilterSize

Especifica el tamaño máximo de filtro en bytes. Si el filtro está en forma directa, el tamaño máximo es el orden del filtro (el numerador y el denominador tienen el mismo orden). Si el filtro está en cascada, el tamaño máximo es el número máximo de coeficientes biquadraticos.

FilterTransientMuteLength

Especifica cuánto tiempo se retrasa el desvanecimiento cruzado al nuevo filtro para evitar introducir la señal transitoria inicial del nuevo filtro en la señal de salida. El retraso se especifica como una serie de muestras iniciales producidas por el nuevo filtro. Durante este tiempo, la salida procede solo de los filtros antiguos.

FilterOverlapBufferLength

Especifica el número total de muestras sobre las que silenciar y atenuar las salidas del filtro.

OutputOverlapBufferLength

Especifica el número de muestras en las que se van a cruzar los canales de salida después de una transición a través del ángulo azimuth cero. Este miembro se usa cuando el miembro cross-fading de los canales de salida está habilitado por la crossFadeOutput miembro de KSDS3D_HRTF_PARAMS_MSG.

Reserved

Reservado. Establézcalo en cero.

Observaciones

Esta estructura la usa la propiedad KSPROPERTY_HRTF3D_INITIALIZE.

Los valores quality FULL_FILTER y LIGHT_FILTER corresponden a la configuración de GUID_DS3DALG_HRTF_FULL y GUID_DS3DALG_HRTF_LIGHT que se describen en la documentación de Microsoft Windows SDK.

Para obtener más información, vea KSPROPSETID_Hrtf3d.

Requisitos

Requisito Valor
encabezado de ksmedia.h (incluya Ksmedia.h)

Consulte también

KSDS3D_HRTF_PARAMS_MSG

KSPROPERTY_HRTF3D_INITIALIZE

KSPROPSETID_Hrtf3d