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 |
|---|---|
|
Opération réussie. |
|
Échec. |
|
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 |