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