共用方式為

SpatialAudioObjectRenderStreamForMetadataActivationParams 結構 (spatialaudiometadata.h)

  • 發行項

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

語法

typedef struct SpatialAudioObjectRenderStreamForMetadataActivationParams {
  const WAVEFORMATEX                    *ObjectFormat;
  AudioObjectType                       StaticObjectTypeMask;
  UINT32                                MinDynamicObjectCount;
  UINT32                                MaxDynamicObjectCount;
  AUDIO_STREAM_CATEGORY                 Category;
  HANDLE                                EventHandle;
  GUID                                  MetadataFormatId;
  UINT16                                MaxMetadataItemCount;
  const PROPVARIANT                     *MetadataActivationParams;
  ISpatialAudioObjectRenderStreamNotify *NotifyObject;
} SpatialAudioObjectRenderStreamForMetadataActivationParams;

成員

ObjectFormat

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

StaticObjectTypeMask

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

MinDynamicObjectCount

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

MaxDynamicObjectCount

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

Category

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

EventHandle

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

MetadataFormatId

目前使用中空間轉譯引擎之元數據格式的標識碼。

MaxMetadataItemCount

每個畫面的元數據項目數目上限。

MetadataActivationParams

其他啟用參數。

NotifyObject

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

規格需求

需求 值
標頭 spatialaudiometadata.h