Interface IWMProfile
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 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. Lors de l’accès à 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 a des méthodes pour créer un nouveau profil et 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 toute interface de lecteur. De même, toute interface de l’objet de 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 possède 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 à partir 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 Services Windows Media dans le profil. |
| ReconfigStream | 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 pouvant ê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.