ISpatialAudioMetadataWriter::WriteNextItemCommand-Methode (spatialaudiometadata.h)
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 |
|---|---|
|
ISpatialAudioMetadataItems wurde nicht zum Schreiben mit einem Aufruf von Open geöffnet, oder das Objekt wurde zum Schreiben mit einem Aufruf von Close geschlossen. |
|
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 |