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

Метод ISpatialAudioMetadataWriter::WriteNextItemCommand (spatialaudiometadata.h)

  • Статья

Записывает команды метаданных и данные значений в текущий элемент.

Синтаксис

HRESULT WriteNextItemCommand(
  [in] BYTE       commandID,
  [in] const void *valueBuffer,
  [in] UINT32     valueBufferLength
);

Параметры

[in] commandID

Команда, поддерживаемая форматом метаданных объекта . Вызов завершится ошибкой, если команда не определена в формате метаданных. Каждая команда может быть написана только один раз для каждого элемента.

[in] valueBuffer

Указатель на буфер, в котором хранятся данные, относящиеся к команде, в соответствии с определением формата метаданных.

[in] valueBufferLength

Размер (в байтах) командных данных, предоставленных в параметре valueBuffer . Размер должен соответствовать определению команды, заданному форматом метаданных, в противном случае вызов завершится ошибкой.

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

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

Код возврата Описание
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN
 ISpatialAudioMetadataItems не был открыт для записи с помощью вызова Open или объект был закрыт для записи с помощью вызова Close.
SPTLAUD_MD_CLNT_E_NO_ITEMOFFSET_WRITTEN

Метод WriteNextItem не вызывался после вызова Open и до вызова WriteNextItemCommand.

Комментарии

Необходимо открыть ISpatialAudioMetadataWriter для записи, вызвав Open, и задать смещение текущего элемента метаданных, вызвав WriteNextItem перед вызовомWriteNextItemCommand.

Требования

   
Целевая платформа Windows
Header spatialaudiometadata.h

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

ISpatialAudioMetadataWriter