Método ISpatialAudioMetadataReader::ReadNextItemCommand (spatialaudiometadata.h)

  • Artículo

Lee los comandos de metadatos y los datos de valor del elemento actual.

Sintaxis

HRESULT ReadNextItemCommand(
  [out] BYTE   *commandID,
  [in]  void   *valueBuffer,
  [in]  UINT32 maxValueBufferLength,
  [out] UINT32 *valueBufferLength
);

Parámetros

[out] commandID

Recibe el identificador de comando del comando actual.

[in] valueBuffer

Puntero a un búfer que recibe datos específicos del comando según lo especificado por la definición de formato de metadatos. El búfer debe ser al menos maxValueBufferLength para asegurarse de que todos los comandos se pueden recuperar correctamente.

[in] maxValueBufferLength

Tamaño máximo de un valor de comando.

[out] valueBufferLength

Tamaño, en bytes, de los datos escritos en el parámetro valueBuffer .

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los posibles códigos de retorno incluyen, pero no están limitados a, los valores que se muestran en la tabla siguiente.

Código devuelto Descripción
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN
 No se ha abierto ISpatialAudioMetadataItems para leer con una llamada a Open o el objeto se ha cerrado para escribir con una llamada a Close.
E_INVALIDARG
 Uno de los punteros proporcionados no es válido.

Comentarios

Antes de llamar a ReadNextItem, debe abrir ISpatialAudioMetadataReader para leer llamando a Open después de crear el objeto y después de llamar a Close . También debe llamar a ReadItemCountInFrames y, a continuación, llamar a ReadNextItem antes de llamar a ReadNextItem.

El ISpatialAudioMetadataReader mantiene un puntero interno a la posición actual dentro del intervalo total de fotogramas contenidos por los ISpatialAudioMetadataItems con los 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 lea todo el intervalo de fotogramas del ISpatialAudioMetadataItems .

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado spatialaudiometadata.h

Consulte también

ISpatialAudioMetadataReader