Método ISpatialAudioMetadataReader::ReadNextItem (spatialaudiometadata.h)
Obtiene el número de comandos y el desplazamiento de ejemplo para el elemento de metadatos que se va a leer.
Sintaxis
HRESULT ReadNextItem(
[out] UINT8 *commandCount,
[out] UINT16 *frameOffset
);
Parámetros
[out] commandCount
Recibe el número de pares de comando y valor en el elemento de metadatos que se va a leer.
[out] frameOffset
Obtiene el desplazamiento de marco asociado al elemento de metadatos que se va a leer.
Valor devuelto
Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los códigos de retorno posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.
| Código devuelto | Descripción |
|---|---|
|
ISpatialAudioMetadataItems no se ha abierto para leer con una llamada a Open o el objeto se ha cerrado para escribir con una llamada a Close. |
|
No hay más elementos de metadatos en el intervalo de fotogramas especificado en la llamada a ReadItemCountInFrames. |
|
Uno de los punteros proporcionados no es válido. |
Comentarios
Antes de llamar a ReadNextItem, debe abrir ISpatialAudioMetadataReader para su lectura llamando a Open después de crear el objeto y después de llamar a Close . También debe llamar a ReadItemCountInFrames antes de llamar a ReadNextItem.
El ISpatialAudioMetadataReader mantiene un puntero interno a la posición actual dentro del intervalo total de fotogramas contenidos en el ISpatialAudioMetadataItems con el que está asociado el lector. Cada llamada a este método hace que el puntero esté avanzado por el número de fotogramas especificados en el parámetro readFrameCount .
El proceso para leer comandos y los valores asociados es recursivo. Después de cada llamada a ReadItemCountInFrames, llame a ReadNextItem para obtener el número de comandos del siguiente elemento. Después de cada llamada a ReadNextItem, llame a ReadNextItemCommand para leer cada comando del elemento. Repita este proceso hasta que se haya leído todo el intervalo de fotogramas de ISpatialAudioMetadataItems .
Requisitos
| Plataforma de destino | Windows |
| Encabezado | spatialaudiometadata.h |