Trabajar con metadatos
[La característica asociada a esta página, SDK de Windows Media Format 11, es una característica heredada. Se ha reemplazado por lector de origen y escritor receptor. El lector de origen y el sistema de escritura receptor se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use lector de origen y escritor receptor en lugar del SDK de Windows Media Format 11, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
El objeto writer proporciona compatibilidad con metadatos, el lector y los objetos de lector sincrónicos y el objeto del editor de metadatos. Para obtener información general sobre los metadatos, vea Metadatos. Para obtener información sobre las características que admiten metadatos en el SDK de Windows Media Format, consulte Características de metadatos.
La interfaz para la edición de metadatos es IWMHeaderInfo3, que puede obtener llamando al método QueryInterface de cualquier interfaz en uno de los objetos enumerados anteriormente. IWMHeaderInfo3 hereda los métodos de IWMHeaderInfo e IWMHeaderInfo2. Los métodos de IWMHeaderInfo3 que tratan con atributos de metadatos representan un enfoque diferente para acceder a los metadatos que los que usan los métodos de IWMHeaderInfo. Siempre debe usar los métodos más recientes.
Los metadatos de un archivo ASF se identifican mediante un índice y un número de secuencia. A los atributos de nivel de archivo se les asigna un número de secuencia de 0. En versiones anteriores del SDK de Windows Media Format, los atributos podrían identificarse por nombre. Sin embargo, dado que ahora puede duplicar nombres de atributo dentro de una secuencia, ya no es posible. En su lugar, puede recuperar todos los índices que coinciden con un nombre. Para obtener más información, consulte Recuperación de atributos de metadatos.
Para ayudar a encontrar atributos rápidamente, puede usar un número de flujo especial, 0xFFFF. Use este número de secuencia para identificar el archivo como un todo, en lugar de una secuencia específica o los atributos de nivel de archivo. Los objetos del SDK de Windows Media Format mantienen índices independientes para cada secuencia y para los atributos de nivel de archivo. Al usar 0xFFFF de secuencia, los índices son diferentes de los que se usan al especificar una secuencia específica. Por ejemplo, el atributo que es el índice 0 para la secuencia 0 no será el mismo que el atributo que es el índice 0 para la secuencia 0xFFFF.
En las secciones siguientes se describe el uso de metadatos con mayor detalle.
| Sección | Descripción |
|---|---|
| Recuperación de atributos de metadatos | Describe cómo leer atributos de metadatos de un encabezado de archivo. |
| Establecer atributos de metadatos | Describe cómo agregar nuevos atributos de metadatos a un encabezado de archivo. |
| Edición de atributos de metadatos | Describe cómo editar los atributos de metadatos existentes. |
| Eliminación de atributos de metadatos | Describe cómo quitar los atributos de metadatos existentes. |
| Uso de atributos de metadatos complejos | Describe cómo trabajar con atributos cuyos valores se representan mediante estructuras. |
Varias de las aplicaciones de ejemplo muestran cómo recuperar y editar metadatos. En concreto, consulte el ejemplo MetadataEdit, que viene en las versiones de C++ y C#.
Temas relacionados