Méthode IFilterGraph::RemoveFilter (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 dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est 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.]

La RemoveFilter méthode supprime un filtre du graphe.

Syntaxe

HRESULT RemoveFilter(
  [in] IBaseFilter *pFilter
);

Paramètres

[in] pFilter

Pointeur vers le filtre à supprimer du graphique.

Valeur renvoyée

Retourne l’une des valeurs suivantes.

Notes

Le Gestionnaire de graphes de filtre avertit le filtre qu’il est supprimé en appelant la méthode IBaseFilter::JoinFilterGraph du filtre avec un argument NULL . Il n’est pas nécessaire de déconnecter les broches du filtre avant d’appeler RemoveFilter, mais le graphe de filtre doit être à l’état Arrêté. Si les filtres ne sont pas arrêtés, RemoveFilter peut ne pas déconnecter les broches, puis ne pas supprimer le filtre du graphique. IGraphConfig::RemoveFilterEx permet à une application de supprimer un filtre sans déconnecter automatiquement les broches, ce qui améliore les performances si vous souhaitez déplacer des groupes de filtres connectés dans un nouveau graphique.

Configuration requise

Voir aussi

Codes d’erreur et de réussite

IFilterGraph Interface