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

Inicia un nuevo elemento de metadatos en el desplazamiento especificado.

Sintaxis

HRESULT WriteNextItem(
  [in] UINT16 frameOffset
);

Parámetros

[in] frameOffset

Desplazamiento de fotograma del elemento dentro del intervalo especificado con el parámetro frameCount para ActivateSpatialAudioMetadataItems.

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	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_FRAMEOFFSET_OUT_OF_RANGE	El número de elementos escritos en la sesión de escritura es mayor que el valor proporcionado en el campo MaxMetadataItemCount del spatialAudioObjectRenderStreamForMetadataActivationParam pasado a ISpatialAudioClient::ActivateSpatialAudioStream. El valor frameCount es mayor que el valor del parámetro frameCount en ActivateSpatialAudioMetadataItems y el modo de desbordamiento se estableció en SpatialAudioMetadataWriterOverflow_Fail.
E_INVALIDARG	El valor de frameOffset no es mayor que el valor proporcionado en la llamada anterior a WriteNextItem dentro de la misma sesión de escritura.

Comentarios

Antes de llamar a WriteNextItem, debe abrir ISpatialAudioMetadataWriter para escribir llamando a Open después de crear el objeto y después de llamar a Close . Durante una sesión de escritura delimitada por llamadas a Open y Close, el valor del parámetro frameOffset debe ser mayor que el valor de la llamada anterior.

Dentro de una sola sesión de escritura, no debe usar WriteNextItem para escribir más elementos que el valor proporcionado en el campo MaxMetadataItemCount en el spatialAudioObjectRenderStreamForMetadataActivationParam pasado a ISpatialAudioClient::ActivateSpatialAudioStream o se producirá un error de SPTLAUD_MD_CLNT_E_FRAMEOFFSET_OUT_OF_RANGE.

Si el modo de desbordamiento se establece en SpatialAudioMetadataWriterOverflow_Fail, el valor del parámetro frameOffset debe ser menor que el valor del parámetro frameCount en ActivateSpatialAudioMetadataItems o se producirá un error SPTLAUD_MD_CLNT_E_FRAMEOFFSET_OUT_OF_RANGE.

Después de llamar a WriteNextItem, llame a WriteNextItemCommand para escribir comandos de metadatos y datos de valor para el elemento.

Requisitos

Plataforma de destino	Windows
Encabezado	spatialaudiometadata.h

Consulte también

ISpatialAudioMetadataWriter