SpatialAudioObjectRenderStreamActivationParams 結構 (spatialaudioclient.h)

表示空間音訊轉譯資料流程的啟用參數。 啟用資料流程時，將此結構傳遞至 ISpatialAudioClient：：ActivateSpatialAudioStream 。

語法

typedef struct SpatialAudioObjectRenderStreamActivationParams {
  const WAVEFORMATEX                    *ObjectFormat;
  AudioObjectType                       StaticObjectTypeMask;
  UINT32                                MinDynamicObjectCount;
  UINT32                                MaxDynamicObjectCount;
  AUDIO_STREAM_CATEGORY                 Category;
  HANDLE                                EventHandle;
  ISpatialAudioObjectRenderStreamNotify *NotifyObject;
} SpatialAudioObjectRenderStreamActivationParams;

成員

ObjectFormat

格式化單一空間音訊物件的描述元。 資料流程使用的所有物件都必須具有相同的格式，而且格式必須是 類型為「顯示」X 或「限制 性 」XTENSIBLE。

StaticObjectTypeMask

AudioObjectType值的位元組合，表示啟動資料流程將允許的靜態空間音訊通道集。

MinDynamicObjectCount

並行動態物件的數目下限。 如果無法同時啟動這個數目的動態音訊物件， ISpatialAudioClient：：ActivateSpatialAudioStream 將會失敗，並出現此錯誤 SPTLAUDCLNT_E_NO_MORE_OBJECTS。

MaxDynamicObjectCount

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

Category

音訊資料流程及其空間音訊物件的類別。

EventHandle

會向用戶端發出訊號的事件，以提供更多音訊資料。 使用這個控制碼之前，會在內部重複此控制碼。

NotifyObject

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

規格需求