ISpatialAudioMetadataWriter 接口 (spatialaudiometadata.h)

提供用于存储位于相应音频帧范围内的空间音频元数据项的方法。 每个元数据项在指定的帧中都有一个从零开始的偏移位置。 创建 ISpatialAudioMetadataClient 时，每个项可以包含特定于 SpatialAudioObjectRenderStreamForMetadataActivationParams 中提供的元数据格式 ID 的一个或多个命令。
此对象不为其提供的元数据分配存储，调用方应管理用于存储已打包数据的内存分配。 可以将多个元数据项放置在 ISpatialAudioMetadataItems 对象中。 对于每个项，调用 WriteNextItem ，然后调用 WriteNextItemCommand。

此接口是 Windows Sonic（Microsoft 的音频平台）的一部分，该平台提供更身临其境的音频，其中包括 Xbox 和 Windows 上的集成空间音效。

继承

ISpatialAudioMetadataWriter 接口继承自 IUnknown 接口。 ISpatialAudioMetadataWriter 也具有以下类型的成员：

方法

ISpatialAudioMetadataWriter 接口包含以下方法。

ISpatialAudioMetadataWriter：：Close 在元数据缓冲区上完成任何所需的操作，并释放指定的 ISpatialAudioMetadataItems 对象。
ISpatialAudioMetadataWriter：：Open 打开 ISpatialAudioMetadataItems 对象以供写入。
ISpatialAudioMetadataWriter：：WriteNextItem 在指定的偏移量处启动新的元数据项。
ISpatialAudioMetadataWriter：：WriteNextItemCommand 将元数据命令和值数据写入当前项。

要求

要求	值
最低受支持的客户端	Windows 10版本 1703 [仅限桌面应用]
最低受支持的服务器	Windows Server 2016 [仅限桌面应用]
目标平台	Windows
标头	spatialaudiometadata.h