Objet Profile
[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 objet de profil gère les paramètres d’un profil. Les objets de profil peuvent être créés pour les données de profil existantes ou peuvent être créés vides, prêts à recevoir de nouvelles données. Un objet de profil est également créé par l’objet lecteur (et l’objet lecteur synchrone) lorsqu’un fichier est chargé pour la lecture. Dans ce cas, l’objet est rempli avec les informations de profil stockées dans l’en-tête du fichier.
Pour enregistrer le contenu d’un objet de profil, vous devez appeler IWMProfileManager::SaveProfile.
Un profil contient plusieurs objets qui contrôlent différents aspects du profil (tels que les flux). Tous ces objets sont subordonnés à l’objet de profil. Vous ne créez pas ces objets avec des fonctions de création comme vous le feriez avec les objets principaux de ce KIT de développement logiciel (SDK). Au lieu de cela, les interfaces de l’objet de profil contiennent des méthodes qui créent les objets subordonnés.
Pour créer un objet de profil, appelez l’une des méthodes suivantes.
| Méthode | Description |
|---|---|
| IWMProfileManager::CreateEmptyProfile | Crée un objet de profil sans données de profil. |
| IWMProfileManager::LoadProfileByData | Crée un objet de profil rempli avec les données d’un profil enregistré sous forme de chaîne. Il s’agit de la seule façon de créer un objet de profil avec des données à partir d’un profil personnalisé. |
| IWMProfileManager::LoadProfileByID | Crée un objet de profil rempli avec des données d’un profil système. Utilise le GUID pour identifier le profil système souhaité. |
| IWMProfileManager::LoadSystemProfile | Crée un objet de profil rempli avec des données d’un profil système. Utilise l’index de profil pour identifier le profil système souhaité. |
Toutes les méthodes de la table précédente définissent un pointeur vers une interface IWMProfile . Les autres interfaces de l’objet de profil peuvent être obtenues en appelant la méthode QueryInterface .
Les interfaces suivantes sont prises en charge par chaque objet de profil.
| Interface | Description |
|---|---|
| IWMLanguageList | Gère une liste de langues prises en charge par un fichier ASF. |
| IWMPacketSize | Contrôle la taille maximale des paquets dans un fichier. |
| IWMPacketSize2 | Contrôle la taille minimale des paquets dans un fichier. Hérite de toutes les méthodes d’IWMPacketSize. |
| IWMProfile | Contrôle les paramètres de base et les objets inclus dans un profil. |
| IWMProfile2 | Récupère l’identificateur global unique (GUID) associé au profil. Hérite de toutes les méthodes d’IWMProfile. |
| IWMProfile3 | Contrôle le partage de bande passante et les informations de hiérarchisation du flux dans un profil. Hérite de toutes les méthodes de IWMProfile et IWMProfile2. |
Rubriques connexes