Interface IWMProfile
[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 le lecteur source et l’enregistreurré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.]
L’interface IWMProfile est l’interface principale d’un objet de profil . Un objet de profil est utilisé pour configurer des profils personnalisés. Vous pouvez utiliser IWMProfile pour créer, supprimer ou modifier des objets de configuration de flux et des objets d’exclusion mutuelle. Vous pouvez également définir et récupérer des informations générales sur le profil. Pour accéder à toutes les fonctionnalités de l’objet de profil, vous devez utiliser IWMProfile3, qui hérite de IWMProfile et IWMProfile2.
IWMProfile est également accessible via l’objet reader, où vous pouvez l’utiliser pour obtenir des informations sur les flux d’un fichier chargé dans le lecteur. Lorsque vous accédez à IWMProfile à partir du lecteur, vous pouvez apporter des modifications au profil, mais aucune des modifications ne peut être enregistrée dans le fichier. Il est souvent pratique d’utiliser le profil d’un fichier existant comme base d’un nouveau profil. Le lecteur synchrone prend en charge IWMProfile de la même façon que le lecteur.
Les informations de profil obtenues via le lecteur ou le lecteur synchrone ne proviennent pas d’un fichier .prx. Le lecteur utilise les informations du fichier ASF pour assembler les configurations de flux. Ainsi, certaines informations de profil, telles que le nom et la description, ne sont pas disponibles via le lecteur.
Il existe plusieurs façons d’obtenir un pointeur vers une interface IWMProfile . Le gestionnaire de profils dispose de méthodes permettant de créer un profil et d’accéder aux profils existants. Toutes ces méthodes définissent un pointeur IWMProfile . Lors de la lecture d’un fichier, un pointeur vers IWMProfile peut être obtenu en appelant la méthode QueryInterface de n’importe quelle interface de lecteur. De même, toute interface de l’objet lecteur synchrone peut obtenir un pointeur avec un appel à QueryInterfaceIWMProfile3.
Membres
L’interface IWMProfile hérite de l’interface IUnknown . IWMProfile a également les types de membres suivants :
Méthodes
L’interface IWMProfile utilise ces méthodes.
| Méthode | Description |
|---|---|
| AddMutualExclusion | Ajoute un objet d’exclusion mutuelle au profil. |
| AddStream | Ajoute un flux au profil. |
| CreateNewMutualExclusion | Crée un objet d’exclusion mutuelle pour le profil. |
| CreateNewStream | Crée un objet de configuration de flux pour le profil. |
| GetDescription | Récupère la description du profil. |
| GetMutualExclusion | Récupère un objet d’exclusion mutuelle du profil. |
| GetMutualExclusionCount | Récupère le nombre d’objets d’exclusion mutuelle dans le profil. |
| GetName | Récupère le nom du profil. |
| GetStream | Récupère un flux, à l’aide d’un numéro d’index, à partir du profil. |
| GetStreamByNumber | Récupère un flux, à l’aide du numéro du flux, à partir du profil. |
| GetStreamCount | Récupère le nombre de flux dans le profil. |
| GetVersion | Récupère le numéro de version de Microsoft Windows Media Services dans le profil. |
| ReconfigurerStream | Permet d’inclure les modifications apportées à une configuration de flux dans le profil. |
| RemoveMutualExclusion | Supprime un objet d’exclusion mutuelle du profil. |
| RemoveStream | Supprime un flux du profil. |
| RemoveStreamByNumber | Supprime un flux du profil. |
| SetDescription | Spécifie la description du profil. |
| SetName | Spécifie le nom du profil. |
Pour plus d’informations sur les interfaces qui peuvent être obtenues à l’aide de la méthode QueryInterface de cette interface, consultez la rubrique relative à l’objet sur lequel cette interface est implémentée.