Метод ISpatialAudioMetadataItemsBuffer::AttachToPopulatedBuffer (spatialaudiometadata.h)

Статья
03/05/2024

Присоединяет ранее заполненный буфер для хранения объектов ISpatialAudioMetadataItems . Элементы метаданных, уже находящиеся в буфере, сохраняются.

Синтаксис

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

Параметры

[in] buffer

Указатель на память, используемую для хранения.

bufferLength

Длина предоставленного буфера. Этот размер должен соответствовать длине, необходимой для формата метаданных, и максимальному количеству элементов метаданных.

Возвращаемое значение

Если метод завершается успешно, возвращает значение S_OK. В случае сбоя возможные коды возврата включают, помимо прочего, значения, показанные в следующей таблице.

Код возврата	Описание
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
Header	spatialaudiometadata.h

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

ISpatialAudioMetadataItemsBuffer

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