ISpatialAudioMetadataItemsBuffer：：AttachToPopulatedBuffer 方法 (spatialaudiometadata.h)

附加先前填入的緩衝區，以儲存 ISpatialAudioMetadataItems 物件。緩衝區中已經有的元數據專案會保留。

語法

HRESULT AttachToPopulatedBuffer(
  [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_BUFFER_ALREADY_ATTACHED	提供的緩衝區已經附加。
SPTLAUD_MD_CLNT_E_ATTACH_FAILED_INTERNAL_BUFFER	ISpatialAudioMetadataItems 已建立為使用媒體管線內部緩衝區，因此無法附加外部緩衝區。
SPTLAUD_MD_CLNT_E_FORMAT_MISMATCH	提供的填入緩衝區會使用不同於目前格式的格式。
E_INVALIDARG	其中一個提供的指標無效。提供的緩衝區不夠大，無法保存元數據專案的最大數目。呼叫 GetSpatialAudioMetadataItemsBufferLength 以判斷所需的緩衝區大小。

需求	值
目標平台	Windows
標頭	spatialaudiometadata.h