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

指定采样率（以每秒样本数 (赫) ），每个通道的播放频率。 例如，值为 22,050 将采样率指定为 22.05 kHz。

MaxFilterSize

指定最大筛选器大小（以字节为单位）。 如果筛选器采用直接形式，则最大大小为筛选器的顺序 (分子和分母具有相等的顺序) 。 如果筛选器为级联形式，则最大大小为双四形系数的最大数目。

FilterTransientMuteLength

指定将交叉淡化延迟到新筛选器的时长，以避免将新筛选器的初始暂时性信号引入输出信号。 延迟指定为新筛选器生成的多个初始样本。 在此期间，输出仅来自旧筛选器。

FilterOverlapBufferLength

指定要对其静音和交叉淡化筛选器输出的样本总数。

OutputOverlapBufferLength

指定在跨方位角零的转换后，输出通道交叉淡入的样本数。 当输出通道的交叉淡化由 KSDS3D_HRTF_PARAMS_MSG 的 CrossFadeOutput 成员启用时，将使用此成员。

Reserved

保留。 设置为零。

注解

此结构由 KSPROPERTY_HRTF3D_INITIALIZE 属性使用。

质量值FULL_FILTER和LIGHT_FILTER对应于Microsoft Windows SDK文档中介绍的GUID_DS3DALG_HRTF_FULL和GUID_DS3DALG_HRTF_LIGHT设置。

有关详细信息，请参阅 KSPROPSETID_Hrtf3d。

要求

要求 值
Header ksmedia.h (包括 Ksmedia.h)

另请参阅

KSDS3D_HRTF_PARAMS_MSG

KSPROPERTY_HRTF3D_INITIALIZE

KSPROPSETID_Hrtf3d