Profils
[La fonctionnalité associée à cette page, sdk Windows Media Format 11, est une fonctionnalité héritée. Il a été remplacé par lecteur source et enregistreur récepteur. lecteur source et enregistreur récepteur ont été optimisés pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise lecteur source et enregistreur récepteur au lieu d'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.]
Un profil est une collection de données qui décrit la configuration d’un fichier ASF. Au minimum, un profil doit contenir des paramètres de configuration pour un seul flux.
Les informations de flux d’un profil contiennent le débit de bits, la fenêtre de mémoire tampon et les propriétés multimédias du flux. Les informations de flux pour l’audio et la vidéo décrivent exactement la façon dont le média est configuré dans le fichier, y compris le codec (le cas échéant) qui sera utilisé pour compresser les données.
Un profil contient également des informations sur les différentes fonctionnalités de fichier ASF qui seront utilisées dans les fichiers créés avec celui-ci. Ceux-ci incluent d’exclusion mutuelle, de hiérarchisation de flux de données, de partage de bande passante et extensions d’unité de données.
Les versions précédentes du Kit de développement logiciel (SDK) Windows Media Format fournissaient des profils système préconfigurés, qui pourraient être utilisés pour créer des types de fichiers courants ou modifiés légèrement en fonction des besoins de votre application. Les profils système ne sont pas pris en charge pour les codecs de la série Windows Media 9. Cela est dû au fait que le nombre de types de fichiers « courants » a augmenté de façon exponentielle avec l’ajout de nouvelles fonctionnalités. On s’attend à ce que pratiquement chaque créateur de contenu ait besoin d’aller au-delà des solutions simples fournies par les profils système. Vous pouvez toujours utiliser les anciens profils système comme emplacement de départ. Pour plus d’informations, consultez Utilisation des profils système.
Vous devez fournir à l’enregistreur un profil pour chaque fichier que vous écrivez. Vous pouvez spécifier un profil à utiliser avec l’enregistreur en appelant IWMWriter ::SetProfile.
Les données de profil existent sous plusieurs formes différentes qui peuvent être utilisées par le Kit de développement logiciel (SDK) windows Media Format. Les informations de profil sont également accessibles de plusieurs façons. Cela peut entraîner une confusion quant à ce qu’est un profil et à la façon dont il est utilisé.
Le diagramme suivant montre comment les données de profil sont utilisées dans le Kit de développement logiciel (SDK).
Les données de profil prennent trois formes différentes : les données contenues dans un objet de profil dans une application, un fichier XML sur le disque et les données dans l’en-tête d’un fichier ASF. Chacune de ces formes de données s’affiche sous la forme d’un rectangle ombré dans le diagramme.
Données dans un objet de profil
Lorsque vous modifiez un profil, vous utilisez un objet de profil, qui encapsule toutes les données de profil. Vous pouvez créer un objet de profil vide à l’aide de l’objet gestionnaire de profils. Vous pouvez également utiliser l’objet gestionnaire de profils pour charger des données de profil existantes dans un objet de profil.
La plupart des données de profil doivent être ajoutées et manipulées par le biais de l’utilisation d’objets représentant des parties individuelles du profil. Il s’agit notamment d’objets de configuration de flux, d’objets d’exclusion mutuelle, d’objets de partage de bande passante et d’un objet de hiérarchisation de flux. Chacun de ces types d’objets peut être créé à l’aide de méthodes dans l’objet de profil. L’apport de modifications à ces objets n’affecte pas l’objet de profil tant que vous n’avez pas utilisé une méthode dans l’objet de profil pour inclure les données mises à jour de l’autre objet.
Données dans un fichier XML
Les données de profil sont stockées sur le disque sous la forme d’un fichier XML avec l’extension de nom de fichier .prx. Inclus avec le Kit de développement logiciel (SDK) Windows Media Format est une collection de profils appelés profils système qui couvrent les types les plus courants de fichiers ASF. Les profils système sont stockés dans un fichier nommé WMSysPr9.prx. (Notez que ce fichier ne contient en fait aucun profil système pour la série Windows Media 9, car le concept de profils système n’est plus utilisé.) Lorsque vous enregistrez vos propres profils personnalisés, vous devez les enregistrer dans vos propres fichiers.
Vous pouvez utiliser l’objet gestionnaire de profils pour enregistrer les données d’un objet de profil dans une chaîne de texte XML. Vous pouvez ensuite utiliser les fonctions d’E/S de fichier que vous souhaitez enregistrer la chaîne sur un fichier sur le disque.
Données dans l’en-tête d’un fichier ASF
L’enregistreur prend les informations du profil et l’utilise pour créer les flux qui entrent dans la section données du fichier ASF. La majeure partie des données de profil est stockée dans la section d’en-tête du fichier lorsqu’un fichier est écrit. Lors de la lecture, l’objet lecteur (ou l’objet lecteur synchrone) peut accéder aux informations dans l’en-tête du fichier. Dans ce cas, l’objet de lecture crée un objet de profil et le remplit avec les données de l’en-tête.
Lorsque vous accédez aux données de profil à l’aide du lecteur (ou du lecteur synchrone), vous pouvez apporter des modifications aux informations de profil, mais il n’existe aucun moyen d’appliquer ces modifications au fichier dans le lecteur. Vous pouvez appliquer les informations de profil d’un fichier d’un lecteur à un profil dans un enregistreur pour créer un fichier avec les mêmes paramètres que le fichier dans le lecteur. Dans ce cas, toutes les modifications que vous apportez aux informations de profil avant de définir le profil dans l’enregistreur seront reflétées dans les informations de profil inscrites par l’enregistreur.
Utilisation de l’éditeur de profil
Au lieu de créer des profils à l’aide du Kit de développement logiciel (SDK) Windows Media Format, vous pouvez utiliser l’Éditeur de profil, un utilitaire inclus avec l’encodeur Windows Media. Dans votre application d’encodage, utilisez la méthode IWMProfileManager ::LoadProfileByData pour charger le profil enregistré. Dans certains scénarios, par exemple si vous utilisez un nombre limité de profils qui ne sont jamais modifiés dynamiquement, il peut être plus pratique d’utiliser l’Éditeur de profil pour créer vos profils.
Toutefois, si vous utilisez l’Éditeur de profil, il est recommandé de ne pas utiliser le paramètre « Taille de la vidéo : identique à l’entrée vidéo ». Lorsque cette case à cocher est cochée, l’Éditeur de profil crée un profil avec la hauteur et la largeur de sortie vidéo définies sur zéro. Lorsque l’encodeur Windows Media rencontre ces profils, il définit les valeurs appropriées pour qu’elle corresponde à son entrée vidéo. Toutefois, l’enregistreur dans le Kit de développement logiciel (SDK) au format Windows Media ne le fait pas automatiquement. Vous devez donc vous assurer que votre application définit la taille de trame vidéo dans les cas où le profil n’a aucun.
Remarque Certains éléments de configuration de flux ne sont pas stockés dans le profil. Les données du profil décrivent le format du fichier ASF terminé. Les propriétés multimédias d’entrée et d’autres données de configuration utilisées par l’objet writer pour configurer les codecs ne sont pas enregistrées dans le profil. Cela inclut toutes les propriétés définies à l’aide de la méthode IWMPropertyVault ::SetProperty.
Rubriques connexes