Compartilhar via

Método ISpatialAudioMetadataReader::ReadNextItem (spatialaudiometadata.h)

  • Artigo

Obtém o número de comandos e o deslocamento de exemplo para o item de metadados que está sendo lido.

Sintaxe

HRESULT ReadNextItem(
  [out] UINT8  *commandCount,
  [out] UINT16 *frameOffset
);

Parâmetros

[out] commandCount

Recebe o número de pares de comando/valor no item de metadados que está sendo lido.

[out] frameOffset

Obtém o deslocamento de quadro associado ao item de metadados que está sendo lido.

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 leitura com uma chamada para Open ou o objeto foi fechado para gravação com uma chamada para Fechar.
SPTLAUD_MD_CLNT_E_NO_MORE_ITEMS
 Não há mais itens de metadados no intervalo de quadros especificado na chamada para ReadItemCountInFrames.
E_INVALIDARG
 Um dos ponteiros fornecidos não é válido.

Comentários

Antes de chamar ReadNextItem, você deve abrir o ISpatialAudioMetadataReader para leitura chamando Open depois que o objeto for criado e depois que Close tiver sido chamado. Você também deve chamar ReadItemCountInFrames antes de chamar ReadNextItem.

O ISpatialAudioMetadataReader mantém um ponteiro interno para a posição atual dentro do intervalo total de quadros contidos pelo ISpatialAudioMetadataItems ao qual o leitor está associado. Cada chamada a esse método faz com que o ponteiro seja avançado pelo número de quadros especificado no parâmetro readFrameCount .

O processo para ler comandos e os valores associados é recursivo. Após cada chamada para ReadItemCountInFrames, chame ReadNextItem para obter o número de comandos no próximo item. Após cada chamada para ReadNextItem, chame ReadNextItemCommand para ler cada comando do item. Repita esse processo até que todo o intervalo de quadros do ISpatialAudioMetadataItems seja lido.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho spatialaudiometadata.h

Confira também

ISpatialAudioMetadataReader