Compartilhar via


Método ISpatialAudioMetadataWriter::WriteNextItemCommand (spatialaudiometadata.h)

Grava comandos de metadados e dados de valor no item atual.

Sintaxe

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

Parâmetros

[in] commandID

Um comando compatível com o formato de metadados do objeto . A chamada falhará se o comando não for definido pelo formato de metadados. Cada comando só pode ser gravado uma vez por item.

[in] valueBuffer

Um ponteiro para um buffer que armazena dados específicos para o comando, conforme especificado pela definição de formato de metadados.

[in] valueBufferLength

O tamanho, em bytes, dos dados de comando fornecidos no parâmetro valueBuffer . O tamanho deve corresponder à definição de comando especificada pelo formato de metadados ou a chamada falhará.

Valor retornado

Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Código de retorno Descrição
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN
O ISpatialAudioMetadataItems não foi aberto para gravação com uma chamada para Open ou o objeto foi fechado para gravação com uma chamada para Fechar.
SPTLAUD_MD_CLNT_E_NO_ITEMOFFSET_WRITTEN

WriteNextItem não foi chamado depois que Open foi chamado e antes da chamada para WriteNextItemCommand.

Comentários

Você deve abrir o ISpatialAudioMetadataWriter para gravação chamando Open e definir o deslocamento de item de metadados atual chamando WriteNextItem antes de chamar WriteNextItemCommand.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho spatialaudiometadata.h

Confira também

ISpatialAudioMetadataWriter