Méthode IFilterMapper ::RegisterFilter (strmif.h)

Article
03/02/2024

[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.]

Note L’interface IFilterMapper est déconseillée. Utilisez IFilterMapper2 à la place.

Ajoute un filtre au Registre ; le filtre peut ensuite être énuméré.

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)

Voir aussi

Codes d’erreur et de réussite

IFilterMapper, interface

Partager via