estructura KSDS3D_HRTF_INIT_MSG (ksmedia.h)

La estructura KSDS3D_HRTF_INIT_MSG especifica la configuración de parámetro 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 buen efecto de 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 del 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 biquadratices.

FilterTransientMuteLength

Especifica cuánto tiempo se retrasa la atenuación cruzada en el 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 generadas por el nuevo filtro. Durante este tiempo, la salida procede solo de los filtros antiguos.

FilterOverlapBufferLength

Especifica el número total de muestras en las que se silencian y se atenuan las salidas del filtro.

OutputOverlapBufferLength

Especifica el número de muestras en las que se van a atenuar los canales de salida después de una transición a través del ángulo azimuth cero. Este miembro se usa cuando el miembro CrossFadeOutput de KSDS3D_HRTF_PARAMS_MSG habilita la atenuación cruzada de los canales de salida.

Reserved

Reservado. Establecer en cero.

Comentarios

Esta estructura la usa la propiedad KSPROPERTY_HRTF3D_INITIALIZE .

Los valores de calidad 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, consulte KSPROPSETID_Hrtf3d.

Requisitos

Requisito	Valor
Header	ksmedia.h (incluya Ksmedia.h)

Consulte también

KSDS3D_HRTF_PARAMS_MSG

KSPROPERTY_HRTF3D_INITIALIZE

KSPROPSETID_Hrtf3d