Método ISpatialAudioMetadataReader::ReadNextItem (spatialaudiometadata.h)
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 |
|---|---|
|
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. |
|
Não há mais itens de metadados no intervalo de quadros especificado na chamada para ReadItemCountInFrames. |
|
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 |