ISpatialAudioMetadataWriter：：WriteNextItemCommand 方法 (spatialaudiometadata.h)

  • 项目

将元数据命令和值数据写入当前项。

语法

HRESULT WriteNextItemCommand(
  [in] BYTE       commandID,
  [in] const void *valueBuffer,
  [in] UINT32     valueBufferLength
);

参数

[in] commandID

对象的元数据格式支持的命令。 如果命令未通过元数据格式定义，则调用将失败。 每个命令每个项只能写入一次。

[in] valueBuffer

指向缓冲区的指针，该缓冲区存储特定于元数据格式定义所指定的命令的数据。

[in] valueBufferLength

valueBuffer 参数中提供的命令数据的大小（以字节为单位）。 大小必须与元数据格式指定的命令定义匹配，否则调用将失败。

返回值

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

返回代码 说明
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN
 尚未打开 ISpatialAudioMetadataItems 以使用对 Open 的调用进行写入，或者已关闭对象以使用对 Close 的调用进行写入。
SPTLAUD_MD_CLNT_E_NO_ITEMOFFSET_WRITTEN

在调用 Open 之后和调用 WriteNextItemCommand 之前，未调用 WriteNextItem。

注解

必须通过调用 Open 打开 ISpatialAudioMetadataWriter 进行写入，并在调用 WriteNextItemCommand 之前通过调用 WriteNextItem 来设置当前元数据项偏移量。

要求

   
目标平台 Windows
标头 spatialaudiometadata.h

另请参阅

ISpatialAudioMetadataWriter