共用方式為

ISpatialAudioMetadataClient：：ActivateSpatialAudioMetadataItems 方法 (spatialaudiometadata.h)

  • 發行項

建立用來儲存空間音訊中繼資料專案的 ISpatialAudioMetadataItems 物件。

語法

HRESULT ActivateSpatialAudioMetadataItems(
  [in]            UINT16                           maxItemCount,
  [in]            UINT16                           frameCount,
  [out, optional] ISpatialAudioMetadataItemsBuffer **metadataItemsBuffer,
  [out]           ISpatialAudioMetadataItems       **metadataItems
);

參數

[in] maxItemCount

可儲存在傳回 ISpatialAudioMetadataItems中的中繼資料專案數目上限。

[in] frameCount

所傳回 ISpatialAudioMetadataItems中所儲存中繼資料專案的有效畫面位移位置範圍。

[out, optional] metadataItemsBuffer

如果提供指標，會傳回 ISpatialAudioMetadataItemsBuffer 介面，其提供附加呼叫端提供記憶體的方法，以便儲存中繼資料專案。 如果此參數為 Null，物件會為專案配置內部儲存體。 無法透過 QueryInterface取得此介面。

[out] metadataItems

接收實例ISpatialAudioMetadataItems物件，該物件可以使用ISpatialAudioMetadataWriter 或 ISpatialAudioMetadataCopier填入中繼資料專案，而且可以使用ISpatialAudioMetadataReader讀取。

傳回值

如果方法成功，它會傳回 S_OK。 如果失敗，可能的傳回碼包括，但不限於下表所示的值。

傳回碼 描述
E_INVALIDARG
 metadataItems參數中提供的指標無效。

maxItemCount或frameCount的值是 0。

規格需求

   
目標平台 Windows
標頭 spatialaudiometadata.h

另請參閱

ISpatialAudioMetadataClient