ISpatialAudioMetadataItemsBuffer：：AttachToBuffer 方法 (spatialaudiometadata.h)

附加呼叫端提供的記憶體，以儲存 ISpatialAudioMetadataItems 物件。

語法

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

[in] buffer

要用於記憶體的記憶體指標。

bufferLength

提供的緩衝區長度。此大小必須符合元數據格式和元數據項目計數上限所需的長度。

如果方法成功，它會傳回 S_OK。如果失敗，可能的傳回碼包括但不限於下表所示的值。

傳回碼	Description
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