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 applications peuvent également énumérer ces objets indirectement. Par exemple, si une application utilise le chargeur de topologie pour résoudre une topologie partielle, le chargeur de topologie appelle MFTEnumEx pour rechercher les décodeurs requis.

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.
Les exemples suivants illustrent les différents types de clé :
  • Extension de fichier : .wmv »
  • Schéma : « http: »
  • Type MIME : « video/mp4 »
  • Sous-type multimédia : « {47504A4D-0000-0010-8000-00AA00389B71} »
Pour rechercher la liste préférée par nom de clé, appelez la méthode IMFPluginControl::GetPreferredClsid . Pour énumérer la liste entière, appelez la méthode IMFPluginControl::GetPreferredClsidByIndex dans une boucle.

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)

Voir aussi

MFGetPluginControl

Interfaces Media Foundation