Freigeben über


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
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN
ISpatialAudioMetadataItems wurde nicht zum Lesen mit einem Aufruf von Open geöffnet, oder das Objekt wurde zum Schreiben mit einem Aufruf von Close geschlossen.
SPTLAUD_MD_CLNT_E_NO_MORE_ITEMS
Im Rahmenbereich, der im Aufruf von ReadItemCountInFrames angegeben wurde, sind keine Metadatenelemente mehr vorhanden.
E_INVALIDARG
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

Weitere Informationen

ISpatialAudioMetadataReader