Metodo ISpatialAudioMetadataWriter::WriteNextItemCommand (spatialaudiometadata.h)

  • Articolo

Scrive i comandi e i valori dei metadati nell'elemento corrente.

Sintassi

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

Parametri

[in] commandID

Comando supportato dal formato dei metadati dell'oggetto. La chiamata avrà esito negativo se il comando non è definito dal formato dei metadati. Ogni comando può essere scritto una sola volta per ogni elemento.

[in] valueBuffer

Puntatore a un buffer che archivia i dati specifici del comando come specificato dalla definizione del formato dei metadati.

[in] valueBufferLength

Dimensioni, in byte, dei dati del comando forniti nel parametro valueBuffer . Le dimensioni devono corrispondere alla definizione del comando specificata dal formato dei metadati o la chiamata avrà esito negativo.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i codici restituiti possibili includono, ma non sono limitati a, i valori visualizzati nella tabella seguente.

Codice restituito Descrizione
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN
 ISpatialAudioMetadataItems non è stato aperto per la scrittura con una chiamata a Open o l'oggetto è stato chiuso per la scrittura con una chiamata a Close.
SPTLAUD_MD_CLNT_E_NO_ITEMOFFSET_WRITTEN

WriteNextItem non è stato chiamato dopo che Open è stato chiamato e prima della chiamata a WriteNextItemCommand.

Commenti

È necessario aprire ISpatialAudioMetadataWriter per la scrittura chiamando Open e impostando l'offset dell'elemento di metadati corrente chiamando WriteNextItem prima di chiamare WriteNextItemCommand.

Requisiti

   
Piattaforma di destinazione Windows
Intestazione spatialaudiometadata.h

Vedi anche

ISpatialAudioMetadataWriter