SpatialAudioHrtfActivationParams 結構 (spatialaudiohrtf.h)

指定 ISpatialAudioRenderStreamForHrtf 的啟用參數。

語法

typedef struct SpatialAudioHrtfActivationParams {
  const WAVEFORMATEX                    *ObjectFormat;
  AudioObjectType                       StaticObjectTypeMask;
  UINT32                                MinDynamicObjectCount;
  UINT32                                MaxDynamicObjectCount;
  AUDIO_STREAM_CATEGORY                 Category;
  HANDLE                                EventHandle;
  ISpatialAudioObjectRenderStreamNotify *NotifyObject;
  SpatialAudioHrtfDistanceDecay         *DistanceDecay;
  SpatialAudioHrtfDirectivityUnion      *Directivity;
  SpatialAudioHrtfEnvironmentType       *Environment;
  SpatialAudioHrtfOrientation           *Orientation;
} SpatialAudioHrtfActivationParams;

成員

ObjectFormat

為與數據流相關聯的空間音頻物件格式化描述元。 所有物件的格式都必須相同，而且必須是 其類型為 WAVEFORMATEX 或 WAVEFORMATEXTENSIBLE。

StaticObjectTypeMask

AudioObjectType 值的位元組合，指出啟動數據流將允許的靜態空間音訊通道集。

MinDynamicObjectCount

並行動態物件的數目下限。 如果無法同時啟用這個數目的動態音訊物件，將不會啟動任何動態音訊物件。

MaxDynamicObjectCount

可使用 ISpatialAudioRenderStreamForHrtf 啟用的並行動態物件數目上限。

Category

音訊數據流及其空間音訊對象的類別。

EventHandle

會向用戶端發出訊號的事件，以提供更多音訊數據。 使用這個句柄之前，會在內部重複。

NotifyObject

物件，提供空間音訊用戶端通知，以回應 ISpatialAudioRenderStreamForHrtf 狀態的變更。 此物件用來通知用戶端可以同時啟用的動態空間音訊物件數目即將變更。

DistanceDecay

用於與數據流相關聯的 ISpatialAudioObjectForHrtf 物件之衰減模型的選擇性預設值。 如果未使用，則為 nullptr。

Directivity

用於與數據流相關聯的 ISpatialAudioObjectForHrtf 物件之空間音訊直接性模型的選擇性預設值。 如果未使用，則為 nullptr。

Environment

當音訊處理與數據流相關聯的 ISpatialAudioObjectForHrtf 物件時，模擬環境的選擇性預設值。 如果未使用，則為 nullptr。

Orientation

與數據流相關聯的 ISpatialAudioObjectForHrtf 物件方向的選擇性預設值。 如果未使用，則為 nullptr。

規格需求