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 kHz 的取樣率。
MaxFilterSize
指定以位元組為單位的篩選大小上限。 如果篩選格式為直接格式，則大小上限為篩選順序（分子和分母有相等順序）。 如果篩選條件採用串聯形式，則大小上限是雙四元係數的最大數目。
FilterTransientMuteLength
指定延遲交叉淡化到新篩選的時間長度，以避免將新篩選器的初始暫時性訊號引入輸出訊號。 延遲會指定為新篩選所產生的一些初始樣本。 在此期間，輸出僅來自舊的篩選條件。
FilterOverlapBufferLength
指定要靜音和交叉淡出篩選輸出的樣本總數。
OutputOverlapBufferLength
指定要在跨 azimuth 角度零轉換之後交叉淡出輸出通道的樣本數目。 當 CrossFadeOutputKSDS3D_HRTF_PARAMS_MSG成員啟用輸出通道的交叉淡化時，會使用此成員。
Reserved
保留。 設定為零。
言論
KSPROPERTY_HRTF3D_INITIALIZE 屬性會使用此結構。
Quality 值FULL_FILTER和LIGHT_FILTER對應至 Microsoft Windows SDK 檔中所述的GUID_DS3DALG_HRTF_FULL和GUID_DS3DALG_HRTF_LIGHT設定。
如需詳細資訊，請參閱 KSPROPSETID_Hrtf3d。
要求
| 要求 | 價值 |
|---|---|
| 標頭 | ksmedia.h （包括 Ksmedia.h） |