Méthode IFilterMapper ::RegisterFilter (strmif.h)
[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si 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.]
Syntaxe
HRESULT RegisterFilter(
[in] CLSID clsid,
[in] LPCWSTR Name,
[in] DWORD dwMerit
);
Paramètres
[in] clsid
Identificateur global unique (GUID) du filtre.
[in] Name
Nom descriptif du filtre.
[in] dwMerit
Position dans l’ordre d’énumération. Les filtres présentant un mérite plus élevé sont énumérés en premier.
Valeur retournée
Retourne une valeur HRESULT .
Remarques
Le mérite (tel que défini par le paramètre dwMerit ) contrôle l’ordre dans lequel le gestionnaire de graphe de filtre tente des filtres lors de l’exécution d’une opération à la suite d’un appel à IGraphBuilder ::Connect, IGraphBuilder ::Render ou IGraphBuilder ::RenderFile. Le gestionnaire de graphe de filtres recherche tous les filtres inscrits avec le type de média approprié, puis tente celui qui a le mérite le plus élevé, en utilisant d’autres critères dans l’inscription pour choisir entre des filtres avec le même mérite.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Windows |
En-tête | strmif.h (include Dshow.h) |