Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
[A funcionalidade associada a esta página, Windows Media Format 11 SDK, é uma funcionalidade herdada. Foi substituído por Source Reader e Sink Writer. Os Source Reader e Sink Writer foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda vivamente que o novo código utilize Leitor de Origem e Gravador de Destino em vez de SDK do Windows Media Format 11, sempre que 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 Metadata. Para obter informações sobre os recursos que suportam metadados no SDK do Windows Media Format, consulte Recursos de metadados.
A interface para edição de metadados é IWMHeaderInfo3, que você pode obter chamando o QueryInterface método 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 a usada pelos métodos de IWMHeaderInfo. Você deve sempre usar os métodos mais recentes.
Os metadados em um arquivo ASF são identificados por um índice e um número de fluxo. Os atributos de nível de arquivo recebem um número de fluxo de 0. Em versões anteriores do SDK do Windows Media Format, os atributos podiam ser identificados pelo nome. No entanto, como agora você pode duplicar nomes de atributos dentro de um fluxo, isso não é mais possível. Em vez disso, você pode recuperar todos os índices correspondentes a um nome. Para obter mais informações, consulte Recuperando atributos de metadados.
Para ajudar a encontrar 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 de nível de arquivo. Os objetos do SDK do Windows Media Format mantêm índices separados para cada fluxo e para os atributos de nível de arquivo. Ao usar o fluxo 0xFFFF, os índices são diferentes daqueles que se utilizam ao especificar um fluxo. Por exemplo, o atributo que é o índice 0 para o fluxo 0 não será o mesmo que o atributo que é o índice 0 para o fluxo 0xFFFF.
As seções a seguir descrevem o uso de metadados com mais detalhes.
| Secçã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