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.

Voir aussi

Interfaces

Interface IWMProfileManager

Gestionnaire de profils, objet

Lecteur, objet

Lecteur synchrone, objet

Utilisation des profils