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.

Code de retour	Description
S_OK	Opération réussie.
E_FAIL	Échec.
E_POINTER	Argument pointeur NULL .

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

Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IFilterGraph Interface