Interface IMFPluginControl (mfobjects.h)
Contrôle la façon dont les sources multimédias et les transformations sont énumérées dans Microsoft Media Foundation.
Pour obtenir un pointeur vers cette interface, appelez MFGetPluginControl.
Héritage
L’interface IMFPluginControl hérite de l’interface IUnknown. IMFPluginControl a également les types de membres suivants :
Méthodes
L’interface IMFPluginControl contient ces méthodes.
| IMFPluginControl::GetDisabledByIndex ImfPluginControl::GetDisabledByIndex (mfobjects.h) obtient un identificateur de classe (CLSID) à partir de la liste bloquée. |
| IMFPluginControl::GetPreferredClsid Recherche dans la liste par défaut un identificateur de classe (CLSID) qui correspond à un nom de clé spécifié. |
| IMFPluginControl::GetPreferredClsidByIndex La méthode IMFPluginControl::GetPreferredClsidByIndex (mfobjects.h) obtient un identificateur de classe (CLSID) à partir de la liste préférée, spécifiée par la valeur d’index. |
| IMFPluginControl::IsDisabled Demande si un identificateur de classe (CLSID) apparaît dans la liste bloquée. (IMFPluginControl.IsDisabled) |
| IMFPluginControl::SetDisabled Ajoute un identificateur de classe (CLSID) à la liste bloquée ou supprime un CLSID de la liste. (IMFPluginControl.SetDisabled) |
| IMFPluginControl::SetPreferredClsid Ajoute un identificateur de classe (CLSID) à la liste par défaut ou supprime un CLSID de la liste. (IMFPluginControl.SetPreferredClsid) |
Notes
Media Foundation fournit un ensemble de sources multimédias et de décodeurs intégrés. Les applications peuvent les énumérer comme suit :
- Les sources multimédias sont énumérées par le biais du programme de résolution de sources.
- Les transformations, telles que les décodeurs, sont énumérées via les fonctions MFTEnum et MFTEnumEx .
Les tiers peuvent implémenter leurs propres sources multimédias et décodeurs personnalisés, et les inscrire pour l’énumération afin que d’autres applications puissent les utiliser.
Pour contrôler l’ordre d’énumération, Media Foundation gère deux listes de CLSID à l’échelle du processus : une liste préférée et une liste bloquée. Un objet dont le CLSID apparaît dans la liste préférée apparaît en premier dans l’ordre d’énumération. Un objet dont le CLSID apparaît dans la liste bloquée n’est pas énuméré.
Les listes sont initialement remplies à partir du Registre. Les applications peuvent utiliser l’interface IMFPluginControl pour modifier les listes du processus en cours.
La liste par défaut contient un ensemble de paires clé/valeur, où les clés sont des chaînes et les valeurs sont des CLSID. Ces paires clé/valeur sont définies comme suit :
- Pour les sources multimédias, le nom de clé est une extension de nom de fichier, un schéma de protocole ou un type MIME. La valeur est le CLSID d’un gestionnaire de schéma ou d’un gestionnaire d’octets pour cette source multimédia.
- Pour les décodeurs, le nom de la clé est un GUID de sous-type multimédia sous forme de chaîne canonique. (Pour plus d’informations sur les sous-types multimédias, consultez Types de médias.) La valeur est le CLSID de la transformation Media Foundation (MFT) qui implémente le décodeur.
- Extension de fichier : .wmv »
- Schéma : « http: »
- Type MIME : « video/mp4 »
- Sous-type multimédia : « {47504A4D-0000-0010-8000-00AA00389B71} »
La liste bloquée contient une liste de CLSID. Pour énumérer la liste entière, appelez la méthode IMFPluginControl::GetDisabledByIndex dans une boucle. Pour case activée si un CLSID spécifique apparaît dans la liste, appelez la méthode IMFPluginControl::IsDisabled.
Spécifications
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | mfobjects.h (inclure Mfidl.h) |