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) |