Trabalhando com metadados

[O recurso associado a esta página, Windows Media Format 11 SDK, é um recurso herdado. Ele foi substituído por Leitor de Origem e Gravador de Coletor. O Leitor de Origem e o Gravador de Coletor foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o Leitor de Origem e o Gravador de Coletor em vez do SDK do Windows Media Format 11, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O suporte a metadados é fornecido pelo objeto gravador, pelos objetos leitor e leitor síncrono e pelo objeto editor de metadados. Para obter informações gerais sobre metadados, consulte Metadados. Para obter informações sobre os recursos que dão suporte a metadados no SDK de Formato de Mídia do Windows, consulte Recursos de metadados.

A interface para edição de metadados é IWMHeaderInfo3, que você pode obter chamando o método QueryInterface de qualquer interface em um dos objetos listados acima. IWMHeaderInfo3 herda os métodos de IWMHeaderInfo e IWMHeaderInfo2. Os métodos de IWMHeaderInfo3 que lidam com atributos de metadados representam uma abordagem diferente para acessar metadados do que o usado pelos métodos de IWMHeaderInfo. Você sempre deve usar os métodos mais recentes.

Os metadados em um arquivo ASF são identificados por um índice e um número de fluxo. Atributos no nível do arquivo recebem um número de fluxo de 0. Em versões anteriores do SDK de Formato de Mídia do Windows, os atributos podiam ser identificados pelo nome. No entanto, como agora você pode duplicar nomes de atributo em um fluxo, isso não é mais possível. Em vez disso, você pode recuperar todos os índices que correspondem a um nome. Para obter mais informações, consulte Recuperando atributos de metadados.

Para ajudar a localizar atributos rapidamente, você pode usar um número de fluxo especial 0xFFFF. Use esse número de fluxo para identificar o arquivo como um todo, em vez de um fluxo específico ou os atributos no nível do arquivo. Os objetos do SDK de Formato de Mídia do Windows mantêm índices separados para cada fluxo e para os atributos de nível de arquivo. Ao usar 0xFFFF de fluxo, os índices são diferentes daqueles que você usa ao especificar um fluxo específico. Por exemplo, o atributo que é o índice 0 para o fluxo 0 não será o mesmo que o atributo que é index 0 para 0xFFFF de fluxo.

As seções a seguir descrevem o uso de metadados com mais detalhes.

Seção	Descrição
Recuperando atributos de metadados	Descreve como ler atributos de metadados de um cabeçalho de arquivo.
Definindo atributos de metadados	Descreve como adicionar novos atributos de metadados a um cabeçalho de arquivo.
Editando atributos de metadados	Descreve como editar atributos de metadados existentes.
Removendo atributos de metadados	Descreve como remover atributos de metadados existentes.
Usando atributos de metadados complexos	Descreve como trabalhar com atributos cujos valores são representados por estruturas.

 

Vários dos aplicativos de exemplo mostram como recuperar e editar metadados. Em particular, consulte o exemplo MetadataEdit, que vem nas versões C++ e C#.

Tópicos relacionados

Atributos

Guia de Programação

Aplicativos de exemplo