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 |
|---|---|
|
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. |
|
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. |
|
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 |