Método ISpatialAudioMetadataWriter::WriteNextItem (spatialaudiometadata.h)
Inicia um novo item de metadados no deslocamento especificado.
Sintaxe
HRESULT WriteNextItem(
[in] UINT16 frameOffset
);
Parâmetros
[in] frameOffset
O deslocamento de quadro do item dentro do intervalo especificado com o parâmetro frameCount para ActivateSpatialAudioMetadataItems.
Valor retornado
Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.
| Código de retorno | Descrição |
|---|---|
|
O ISpatialAudioMetadataItems não foi aberto para gravação com uma chamada para Open ou o objeto foi fechado para gravação com uma chamada para Fechar. |
|
O número de itens escritos na sessão de escrita é maior do que o valor fornecido no campo MaxMetadataItemCount no SpatialAudioObjectRenderStreamForMetadataActivationParam passado para ISpatialAudioClient::ActivateSpatialAudioStream.
O valor frameCount é maior que o valor do parâmetro frameCount para ActivateSpatialAudioMetadataItems e o modo de estouro foi definido como SpatialAudioMetadataWriterOverflow_Fail. |
|
O valor de frameOffset não é maior que o valor fornecido na chamada anterior para WriteNextItem na mesma sessão de gravação. |
Comentários
Antes de chamar WriteNextItem, você deve abrir o ISpatialAudioMetadataWriter para gravação chamando Open depois que o objeto for criado e depois que Close tiver sido chamado. Durante uma sessão de gravação demarcada por chamadas para Abrir e Fechar, o valor do parâmetro frameOffset deve ser maior que o valor na chamada anterior.
Em uma única sessão de gravação, você não deve usar WriteNextItem para gravar mais itens do que o valor fornecido no campo MaxMetadataItemCount no SpatialAudioObjectRenderStreamForMetadataActivationParam passado para ISpatialAudioClient::ActivateSpatialAudioStream ou ocorrerá um erro de SPTLAUD_MD_CLNT_E_FRAMEOFFSET_OUT_OF_RANGE.
Se o modo de estouro for definido como SpatialAudioMetadataWriterOverflow_Fail, o valor do parâmetro frameOffset deverá ser menor que o valor do parâmetro frameCount para ActivateSpatialAudioMetadataItems ou ocorrerá um erro de SPTLAUD_MD_CLNT_E_FRAMEOFFSET_OUT_OF_RANGE.
Depois de chamar WriteNextItem, chame WriteNextItemCommand para gravar comandos de metadados e dados de valor para o item.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | spatialaudiometadata.h |