Méthode IFilterGraph::AddFilter (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 AddFilter méthode ajoute un filtre au graphique.
Syntaxe
HRESULT AddFilter(
[in] IBaseFilter *pFilter,
[in] LPCWSTR pName
);
Paramètres
[in] pFilter
Pointeur vers l’interface IBaseFilter du filtre à ajouter.
[in] pName
Pointeur vers une chaîne de caractères larges contenant un nom pour le filtre.
Valeur renvoyée
Retourne une valeur HRESULT . Les valeurs possibles sont les suivantes.
| Code de retour | Description |
|---|---|
|
Opération réussie. |
|
Ajout réussi d’un filtre avec un nom en double. |
|
Échec. |
|
Mémoire insuffisante. |
|
Argument pointeur NULL . |
|
L’utilisation de ce filtre est limitée par une clé logicielle. |
|
Échec de l’ajout d’un filtre avec un nom dupliqué. |
Notes
Le nom du filtre peut être NULL, auquel cas le Gestionnaire de graphes de filtre génère un nom. Si le nom n’est pas NULL et n’est pas unique, cette méthode modifie le nom dans une tentative de génération d’un nouveau nom unique. Si cela réussit, cette méthode retourne VFW_S_DUPLICATE_NAME. S’il ne peut pas générer un nom unique, il retourne VFW_E_DUPLICATE_NAME.
AddFilter appelle la méthode IBaseFilter::JoinFilterGraph du filtre pour informer le filtre qu’il a été ajouté. AddFilter doit être appelé avant d’essayer d’utiliser la méthode IGraphBuilder::Connect, IFilterGraph::ConnectDirect ou IGraphBuilder::Render pour connecter ou restituer des broches appartenant au filtre ajouté.
Le Gestionnaire de graphes de filtre contient un nombre de références sur le filtre jusqu’à ce que le filtre soit supprimé du graphe ou que le gestionnaire de graphes de filtre soit libéré.
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 |