Поделиться через


Метод 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
Header spatialaudiometadata.h

См. также раздел

ISpatialAudioMetadataItemsBuffer