ISpatialAudioMetadataReader::ReadNextItem-Methode (spatialaudiometadata.h)
Ruft die Anzahl der Befehle und den Beispieloffset für das zu lesende Metadatenelement ab.
Syntax
HRESULT ReadNextItem(
[out] UINT8 *commandCount,
[out] UINT16 *frameOffset
);
Parameter
[out] commandCount
Empfängt die Anzahl der Befehls-Wert-Paare im zu lesenden Metadatenelement.
[out] frameOffset
Ruft den Frameoffset ab, der dem zu lesenden Metadatenelement zugeordnet ist.
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 Lesen mit einem Aufruf von Open geöffnet, oder das Objekt wurde zum Schreiben mit einem Aufruf von Close geschlossen. |
|
Im Rahmenbereich, der im Aufruf von ReadItemCountInFrames angegeben wurde, sind keine Metadatenelemente mehr vorhanden. |
|
Einer der bereitgestellten Zeiger ist ungültig. |
Hinweise
Vor dem Aufrufen von ReadNextItem müssen Sie den ISpatialAudioMetadataReader zum Lesen öffnen, indem Sie Open aufrufen, nachdem das Objekt erstellt wurde und nachdem Close aufgerufen wurde. Sie müssen auch ReadItemCountInFrames aufrufen, bevor Sie ReadNextItem aufrufen.
Der ISpatialAudioMetadataReader behält einen internen Zeiger auf die aktuelle Position innerhalb des Gesamtbereichs der Frames bei, die von den ISpatialAudioMetadataItems enthalten sind, denen der Reader zugeordnet ist. Jeder Aufruf dieser Methode bewirkt, dass der Zeiger um die Anzahl von Frames erweitert wird, die im readFrameCount-Parameter angegeben ist.
Der Prozess zum Lesen von Befehlen und den zugeordneten Werten ist rekursiv. Rufen Sie nach jedem Aufruf von ReadItemCountInFramesReadNextItem auf, um die Anzahl der Befehle im nächsten Element abzurufen. Rufen Sie nach jedem Aufruf von ReadNextItemReadNextItemCommand auf, um jeden Befehl für das Element zu lesen. Wiederholen Sie diesen Vorgang, bis der gesamte Framebereich von ISpatialAudioMetadataItems gelesen wurde.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | spatialaudiometadata.h |