Compartilhar via


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

E_INVALIDARG
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

Confira também

ISpatialAudioMetadataWriter