структура 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), с которой должен воспроизводиться каждый канал. Например, значение 22 050 указывает частоту дискретизации 22,05 кГц.
MaxFilterSize
Указывает максимальный размер фильтра в байтах. Если фильтр имеет прямую форму, максимальный размер равен порядку фильтра (числитель и знаменатель имеют одинаковый порядок). Если фильтр имеет каскадную форму, максимальный размер — это максимальное число биквадратических коэффициентов.
FilterTransientMuteLength
Указывает, как долго следует задерживать перекрестное увядание нового фильтра, чтобы избежать появления начального временного сигнала нового фильтра в выходной сигнал. Задержка указывается в виде числа исходных выборок, созданных новым фильтром. В течение этого времени выходные данные поступают только из старых фильтров.
FilterOverlapBufferLength
Указывает общее количество выборок, для которых отключаются и перекрестно исчезают выходные данные фильтра.
OutputOverlapBufferLength
Указывает количество выборок, по которым следует перекрестно исчезать выходные каналы после перехода через нулевой угол азимута. Этот элемент используется, когда перекрестное затухание каналов вывода включается членом CrossFadeOutputKSDS3D_HRTF_PARAMS_MSG.
Reserved
Зарезервировано. Задайте нулевое значение.
Комментарии
Эта структура используется свойством KSPROPERTY_HRTF3D_INITIALIZE .
Значения качества FULL_FILTER и LIGHT_FILTER соответствуют параметрам GUID_DS3DALG_HRTF_FULL и GUID_DS3DALG_HRTF_LIGHT, описанным в документации по Microsoft Windows SDK.
Дополнительные сведения см. в разделе KSPROPSETID_Hrtf3d.
Требования
| Требование | Значение |
|---|---|
| Заголовок | ksmedia.h (включая Ksmedia.h) |