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。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | ksmedia.h (包含 Ksmedia.h) |