Profils
[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.]
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 flux unique.
Les informations de flux dans un profil contiennent le débit binaire, 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 comment 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 lui. Il s’agit notamment de l’exclusion mutuelle, de la hiérarchisation des flux, du partage de bande passante et des extensions d’unité de données.
Les versions précédentes du Kit de développement logiciel (SDK) au format Windows Media fournissaient des profils système préconfigurés, qui pouvaient être utilisés pour créer des types de fichiers courants ou légèrement modifiés pour répondre aux besoins de votre application. Les profils système ne sont pas pris en charge pour les codecs de la série Windows Media 9. En effet, 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 tous les créateurs de contenu ont des besoins qui vont au-delà des solutions simples fournies par les profils système. Vous pouvez toujours utiliser les anciens profils système comme point de départ. Pour plus d’informations, consultez Utilisation de profils système.
Vous devez fournir au rédacteur 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) au format Windows Media. Les informations de profil sont également accessibles de plusieurs manières. 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 Profile
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 à l’aide 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’utilisez pas 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. Le Kit de développement logiciel (SDK) au format Windows Media comprend 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 de votre choix pour enregistrer la chaîne dans un fichier sur le disque.
Données dans l’en-tête d’un fichier ASF
L’enregistreur prend les informations du profil et les 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 dans 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’auteur.
Utilisation de l’Éditeur de profil
Au lieu de créer des profils à l’aide du Kit de développement logiciel (SDK) au format Windows Media, vous pouvez utiliser l’Éditeur de profil, un utilitaire inclus dans 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 case activée 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’elles correspondent à 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 l’image vidéo dans les cas où le profil n’en a pas.
Note 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 les 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