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。 如果失败,可能的返回代码包括但不限于下表中显示的值。
返回代码 | 说明 |
---|---|
|
尚未打开 ISpatialAudioMetadataItems 以使用对 Open 的调用进行写入,或者已关闭对象以使用对 Close 的调用进行写入。 |
|
在调用 Open 之后和调用 WriteNextItemCommand 之前,未调用 WriteNextItem。 |
注解
必须通过调用 Open 打开 ISpatialAudioMetadataWriter 进行写入,并在调用 WriteNextItemCommand 之前通过调用 WriteNextItem 来设置当前元数据项偏移量。
要求
目标平台 | Windows |
标头 | spatialaudiometadata.h |