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

指定在 azimuth 角度为零的转换后,要交叉淡化输出通道的样本数。 当 CrossFadeOutputKSDS3D_HRTF_PARAMS_MSG成员启用输出通道的交叉淡化时,将使用此成员。

Reserved

保留。 设置为零。

言论

KSPROPERTY_HRTF3D_INITIALIZE 属性使用此结构。

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

有关详细信息,请参阅 KSPROPSETID_Hrtf3d

要求

要求 价值
标头 ksmedia.h (包括 Ksmedia.h)

另请参阅

KSDS3D_HRTF_PARAMS_MSG

KSPROPERTY_HRTF3D_INITIALIZE

KSPROPSETID_Hrtf3d