Metodo ISpatialAudioMetadataReader::ReadNextItem (spatialaudiometadata.h)

Articolo
03/15/2023

Ottiene il numero di comandi e l'offset di esempio per l'elemento di metadati letto.

Sintassi

HRESULT ReadNextItem(
  [out] UINT8  *commandCount,
  [out] UINT16 *frameOffset
);

Parametri

[out] commandCount

Riceve il numero di coppie comando/valore nell'elemento di metadati da leggere.

[out] frameOffset

Ottiene l'offset del frame associato all'elemento di metadati letto.

Valore restituito

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

Codice restituito	Descrizione
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN	ISpatialAudioMetadataItems non è stato aperto per la lettura con una chiamata a Open o l'oggetto è stato chiuso per la scrittura con una chiamata a Close.
SPTLAUD_MD_CLNT_E_NO_MORE_ITEMS	Non sono presenti altri elementi di metadati nell'intervallo di frame specificato nella chiamata a ReadItemCountInFrames.
E_INVALIDARG	Uno dei puntatori forniti non è valido.

Commenti

Prima di chiamare ReadNextItem, è necessario aprire ISpatialAudioMetadataReader per la lettura chiamando Open dopo aver creato l'oggetto e dopo aver chiamato Close . È anche necessario chiamare ReadItemCountInFrames prima di chiamare ReadNextItem.

ISpatialAudioMetadataReader mantiene un puntatore interno alla posizione corrente all'interno dell'intervallo totale di fotogrammi contenuti negli oggetti ISpatialAudioMetadataItems a cui è associato il lettore. Ogni chiamata a questo metodo fa sì che il puntatore venga avanzato in base al numero di fotogrammi specificato nel parametro readFrameCount .

Il processo di lettura dei comandi e dei valori associati è ricorsivo. Dopo ogni chiamata a ReadItemCountInFrames, chiamare ReadNextItem per ottenere il numero di comandi nell'elemento successivo. Dopo ogni chiamata a ReadNextItem, chiamare ReadNextItemCommand per leggere ogni comando per l'elemento. Ripetere questo processo fino a quando non è stato letto l'intero intervallo di fotogrammi di ISpatialAudioMetadataItems .

Requisiti


Piattaforma di destinazione	Windows
Intestazione	spatialaudiometadata.h

Vedi anche

ISpatialAudioMetadataReader

Share via