Metodo ISpatialAudioMetadataReader::ReadNextItem (spatialaudiometadata.h)
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 |
|---|---|
|
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. |
|
Non sono presenti altri elementi di metadati nell'intervallo di frame specificato nella chiamata a ReadItemCountInFrames. |
|
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 |