Método ISpatialAudioMetadataWriter::WriteNextItemCommand (spatialaudiometadata.h)

Escribe los comandos de metadatos y los datos de valor en el elemento actual.

Sintaxis

HRESULT WriteNextItemCommand(
  [in] BYTE       commandID,
  [in] const void *valueBuffer,
  [in] UINT32     valueBufferLength
);

Parámetros

[in] commandID

Comando admitido por el formato de metadatos del objeto . Se producirá un error en la llamada si el comando no está definido por el formato de metadatos. Cada comando solo se puede escribir una vez por elemento.

[in] valueBuffer

Puntero a un búfer que almacena datos específicos del comando según lo especificado por la definición de formato de metadatos.

[in] valueBufferLength

Tamaño, en bytes, de los datos de comando proporcionados en el parámetro valueBuffer . El tamaño debe coincidir con la definición de comando especificada por el formato de metadatos o se producirá un error en la llamada.

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
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN	ISpatialAudioMetadataItems no se ha abierto para escribir con una llamada a Open o el objeto se ha cerrado para escribir con una llamada a Close.
SPTLAUD_MD_CLNT_E_NO_ITEMOFFSET_WRITTEN	No se llamó a WriteNextItem después de llamar a Open y antes de la llamada a WriteNextItemCommand.

Comentarios

Debe abrir ISpatialAudioMetadataWriter para escribir llamando a Open y establecer el desplazamiento del elemento de metadatos actual llamando a WriteNextItem antes de llamar a WriteNextItemCommand.

Requisitos

Plataforma de destino	Windows
Encabezado	spatialaudiometadata.h

Consulte también

ISpatialAudioMetadataWriter