Utilisation des métadonnées
[La fonctionnalité associée à cette page, le Kit de développement logiciel (SDK) Windows Media Format 11, est une fonctionnalité héritée. Il a été remplacé par lecteur source et enregistreur récepteur. Le lecteur source et l’enregistreur récepteur ont été optimisés pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise le lecteur source et l’enregistreur récepteur au lieu du Kit de développement logiciel (SDK) Windows Media Format 11, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]
La prise en charge des métadonnées est assurée par l’objet writer, le lecteur et les objets lecteur synchrones, et l’objet éditeur de métadonnées. Pour plus d’informations générales sur les métadonnées, consultez Métadonnées. Pour plus d’informations sur les fonctionnalités prenant en charge les métadonnées dans le Kit de développement logiciel (SDK) au format Windows Media, consultez Fonctionnalités de métadonnées.
L’interface pour la modification des métadonnées est IWMHeaderInfo3, que vous pouvez obtenir en appelant la méthode QueryInterface de n’importe quelle interface dans l’un des objets répertoriés ci-dessus. IWMHeaderInfo3 hérite des méthodes de IWMHeaderInfo et IWMHeaderInfo2. Les méthodes d’IWMHeaderInfo3 qui traitent des attributs de métadonnées représentent une approche d’accès aux métadonnées différente de celle utilisée par les méthodes d’IWMHeaderInfo. Vous devez toujours utiliser les méthodes plus récentes.
Les métadonnées d’un fichier ASF sont identifiées par un index et un numéro de flux. Les attributs au niveau du fichier se voient attribuer un nombre de flux de données 0. Dans les versions précédentes du Kit de développement logiciel (SDK) au format Windows Media, les attributs pouvaient être identifiés par leur nom. Toutefois, étant donné que vous pouvez désormais dupliquer des noms d’attributs dans un flux, cela n’est plus possible. Au lieu de cela, vous pouvez récupérer tous les index correspondant à un nom. Pour plus d’informations, consultez Récupération des attributs de métadonnées.
Pour vous aider à trouver rapidement des attributs, vous pouvez utiliser un numéro de flux spécial, 0xFFFF. Utilisez ce numéro de flux pour identifier le fichier dans son ensemble, plutôt qu’un flux spécifique ou les attributs au niveau du fichier. Les objets du Kit de développement logiciel (SDK) au format Windows Media conservent des index distincts pour chaque flux et pour les attributs au niveau du fichier. Lorsque vous utilisez stream 0xFFFF, les index sont différents de ceux que vous utilisez lors de la spécification d’un flux spécifique. Par exemple, l’attribut index 0 pour le flux 0 ne sera pas identique à l’attribut index 0 pour le flux 0xFFFF.
Les sections suivantes décrivent plus en détail l’utilisation des métadonnées.
| Section | Description |
|---|---|
| Récupération des attributs de métadonnées | Décrit comment lire les attributs de métadonnées à partir d’un en-tête de fichier. |
| Définition des attributs de métadonnées | Décrit comment ajouter de nouveaux attributs de métadonnées à un en-tête de fichier. |
| Modification des attributs de métadonnées | Décrit comment modifier des attributs de métadonnées existants. |
| Suppression des attributs de métadonnées | Décrit comment supprimer des attributs de métadonnées existants. |
| Utilisation d’attributs de métadonnées complexes | Décrit comment utiliser des attributs dont les valeurs sont représentées par des structures. |
Plusieurs des exemples d’applications montrent comment récupérer et modifier des métadonnées. En particulier, consultez l’exemple MetadataEdit, qui est fourni dans les versions C++ et C#.
Rubriques connexes