ISpatialAudioMetadataWriter::WriteNextItemCommand-Methode (spatialaudiometadata.h)

  • Artikel

Schreibt Metadatenbefehle und Wertdaten in das aktuelle Element.

Syntax

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

Parameter

[in] commandID

Ein Befehl, der vom Metadatenformat des Objekts unterstützt wird. Der Aufruf schlägt fehl, wenn der Befehl nicht durch das Metadatenformat definiert wird. Jeder Befehl kann nur einmal pro Element geschrieben werden.

[in] valueBuffer

Ein Zeiger auf einen Puffer, der spezifische Daten für den Befehl speichert, wie in der Metadatenformatdefinition angegeben.

[in] valueBufferLength

Die Größe der Befehlsdaten, die im valueBuffer-Parameter angegeben werden, in Bytes. Die Größe muss mit der im Metadatenformat angegebenen Befehlsdefinition übereinstimmen, andernfalls schlägt der Aufruf fehl.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, umfassen mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte, sind jedoch nicht darauf beschränkt.

Rückgabecode Beschreibung
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN
 ISpatialAudioMetadataItems wurde nicht zum Schreiben mit einem Aufruf von Open geöffnet, oder das Objekt wurde zum Schreiben mit einem Aufruf von Close geschlossen.
SPTLAUD_MD_CLNT_E_NO_ITEMOFFSET_WRITTEN

WriteNextItem wurde nach dem Aufruf von Open und vor dem Aufruf von WriteNextItemCommand nicht aufgerufen.

Hinweise

Sie müssen den ISpatialAudioMetadataWriter zum Schreiben öffnen, indem Sie Open aufrufen, und den aktuellen Metadatenelementoffset festlegen, indem Sie WriteNextItem aufrufen, bevor WriteNextItemCommand aufgerufen wird.

Anforderungen

   
Zielplattform Windows
Kopfzeile spatialaudiometadata.h

Weitere Informationen

ISpatialAudioMetadataWriter