структура KSDS3D_HRTF_INIT_MSG (ksmedia.h)
Структура KSDS3D_HRTF_INIT_MSG указывает параметры параметра, используемые для инициализации функции передачи с учетом головы (HRTF).
Синтаксис
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;
Члены
Size
Задает размер структуры в байтах.
Quality
Задает уровень качества фильтра HRTF. Задайте для этого параметра одно из следующих значений перечисления KSDS3D_HRTF_FILTER_QUALITY:
- LIGHT_FILTER выбирает эффективный алгоритм, который создает хороший эффект качества.
- FULL_FILTER выбирает алгоритм, который создает высококачественный эффект, но требует больше времени обработки.
SampleRate
Указывает частоту выборки в примерах в секунду (hertz), с которой должен воспроизводиться каждый канал. Например, значение 22050 указывает частоту выборки 22,05 кГц.
MaxFilterSize
Указывает максимальный размер фильтра в байтах. Если фильтр находится в прямой форме, максимальный размер — это порядок фильтра (числовой и знаменатель имеют равный порядок). Если фильтр находится в каскадной форме, максимальный размер — максимальное число бикудратических коэффициентов.
FilterTransientMuteLength
Указывает, сколько времени требуется отложить перекрестное увядание новому фильтру, чтобы избежать внедрения первоначального временного сигнала нового фильтра в выходной сигнал. Задержка указывается в виде ряда начальных выборок, созданных новым фильтром. В это время выходные данные исходят только из старых фильтров.
FilterOverlapBufferLength
Указывает общее количество выборок, для которых требуется отключить и переключить выходные данные фильтра.
OutputOverlapBufferLength
Указывает количество выборок, по которым следует перекрестно исчезать выходные каналы после перехода по azimuth угловому нулю. Этот элемент используется при перекрестном отключении каналов вывода CrossFadeOutput члена KSDS3D_HRTF_PARAMS_MSG.
Reserved
Скрытный. Установите значение нулю.
Замечания
Эта структура используется свойством KSPROPERTY_HRTF3D_INITIALIZE.
Значения качества FULL_FILTER и LIGHT_FILTER соответствуют параметрам GUID_DS3DALG_HRTF_FULL и GUID_DS3DALG_HRTF_LIGHT, описанным в документации по пакету SDK для Microsoft Windows.
Дополнительные сведения см. в KSPROPSETID_Hrtf3d.
Требования
| Требование | Ценность |
|---|---|
| заголовка | ksmedia.h (include Ksmedia.h) |