Méthode ISpatialAudioMetadataReader::ReadNextItem (spatialaudiometadata.h)
Obtient le nombre de commandes et l’exemple de décalage pour l’élément de métadonnées en cours de lecture.
Syntaxe
HRESULT ReadNextItem(
[out] UINT8 *commandCount,
[out] UINT16 *frameOffset
);
Paramètres
[out] commandCount
Reçoit le nombre de paires commande/valeur dans l’élément de métadonnées en cours de lecture.
[out] frameOffset
Obtient le décalage de frame associé à l’élément de métadonnées en cours de lecture.
Valeur retournée
Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.
| Code de retour | Description |
|---|---|
|
L’objet ISpatialAudioMetadataItems n’a pas été ouvert pour lecture avec un appel à Open ou l’objet a été fermé pour écriture avec un appel à Fermer. |
|
Il n’y a plus d’éléments de métadonnées dans la plage de cadres spécifiée dans l’appel à ReadItemCountInFrames. |
|
L’un des pointeurs fournis n’est pas valide. |
Remarques
Avant d’appeler ReadNextItem, vous devez ouvrir ISpatialAudioMetadataReader pour la lecture en appelant Open après la création de l’objet et après l’appel de Close . Vous devez également appeler ReadItemCountInFrames avant d’appeler ReadNextItem.
ISpatialAudioMetadataReader conserve un pointeur interne vers la position actuelle dans la plage totale de trames contenue par les ISpatialAudioMetadataItems auxquels le lecteur est associé. À chaque appel à cette méthode, le pointeur est avancé par le nombre de trames spécifié dans le paramètre readFrameCount .
Le processus de lecture des commandes et des valeurs associées est récursif. Après chaque appel à ReadItemCountInFrames, appelez ReadNextItem pour obtenir le nombre de commandes dans l’élément suivant. Après chaque appel à ReadNextItem, appelez ReadNextItemCommand pour lire chaque commande de l’élément. Répétez ce processus jusqu’à ce que toute la plage de trames de ISpatialAudioMetadataItems ait été lue.
Configuration requise
| Plateforme cible | Windows |
| En-tête | spatialaudiometadata.h |