ISpatialAudioMetadataItemsBuffer：：AttachToBuffer 方法 (spatialaudiometadata.h)

  • 项目

附加调用方提供的内存，用于存储 ISpatialAudioMetadataItems 对象。

语法

HRESULT AttachToBuffer(
  [in] BYTE   *buffer,
       UINT32 bufferLength
);

参数

[in] buffer

指向要用于存储的内存的指针。

bufferLength

提供的缓冲区的长度。 此大小必须与元数据格式和最大元数据项计数所需的长度匹配。

返回值

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

返回代码 说明
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN
 尚未打开 ISpatialAudioMetadataItems 以通过调用 Open 进行复制，或者已关闭对象以使用对 Close 的调用进行写入。
SPTLAUD_MD_CLNT_E_ATTACH_FAILED_INTERNAL_BUFFER
 ISpatialAudioMetadataItems 是为了使用媒体管道内部缓冲区而创建的，因此无法附加外部缓冲区。
SPTLAUD_MD_CLNT_E_BUFFER_ALREADY_ATTACHED
 已附加提供的缓冲区。
E_INVALIDARG
 提供的指针之一无效。

提供的缓冲区不够大，无法容纳元数据项的最大数目。

要求

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

另请参阅

ISpatialAudioMetadataItemsBuffer