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 角度零轉換之後交叉淡出輸出通道的樣本數目。 當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。

規格需求

另請參閱

KSDS3D_HRTF_PARAMS_MSG

KSPROPERTY_HRTF3D_INITIALIZE

KSPROPSETID_Hrtf3d