SpatialAudioObjectRenderStreamActivationParams2 結構 (spatialaudioclient.h)

代表空間音頻轉譯數據流的啟用參數，擴充 SpatialAudioObjectRenderStreamActivationParams (spatialaudioclient.h) ，並能夠指定數據流選項。 啟用數據流時，將此結構傳遞至 ISpatialAudioClient：：ActivateSpatialAudioStream 。

語法

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

成員

ObjectFormat

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

StaticObjectTypeMask

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

MinDynamicObjectCount

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

MaxDynamicObjectCount

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

Category

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

EventHandle

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

NotifyObject

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

Options

SPATIAL_AUDIO_STREAM_OPTIONS emumeration 的成員，指定啟用音訊數據流的選項。

規格需求

需求	值
最低支援的用戶端	Windows 組建 22000
標頭	spatialaudioclient.h