ISpatialAudioMetadataCopier::CopyMetadataForFrames 方法 (spatialaudiometadata.h)

将提供给 Open 方法的源 ISpatialAudioMetadataItems 中的元数据项复制到目标 ISpatialAudioMetadataItems 对象(使用 dstMetadataItems 参数指定)。 每个调用都会按 copyFrameCount 参数中的帧数推进内部复制位置。

语法

HRESULT CopyMetadataForFrames(
  [in]  UINT16                       copyFrameCount,
  [in]  SpatialAudioMetadataCopyMode copyMode,
  [in]  ISpatialAudioMetadataItems   *dstMetadataItems,
  [out] UINT16                       *itemsCopied
);

参数

[in] copyFrameCount

从当前复制位置复制元数据项的帧数。 复制后,源 SpatialAudioMetadataItems 中的内部复制位置将提升此参数中指定的值。 将此值设置为 0 可复制源 SpatialAudioMetadataItems 中包含的整个帧范围。

[in] copyMode

一个 值,该值指定操作的复制模式。

[in] dstMetadataItems

指向复制操作的目标 SpatialAudioMetadataItems 的指针。

[out] itemsCopied

接收操作中复制的元数据项数。

返回值

如果该方法成功,则它会返回 S_OK。 如果失败,可能的返回代码包括但不限于下表中显示的值。

返回代码 说明
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN
尚未打开 ISpatialAudioMetadataItems 以便通过调用 Open 进行复制,或者已关闭对象以使用对 Close 的调用进行写入。
E_INVALIDARG
提供的指针之一无效。

要求

要求
目标平台 Windows
标头 spatialaudiometadata.h

另请参阅

ISpatialAudioMetadataCopier