Méthode ICaptureGraphBuilder ::SetFiltergraph (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 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.]

NoteL’interface ICaptureGraphBuilder est déconseillée. Utilisez ICaptureGraphBuilder2 à la place.

 

Indique à l’objet générateur de graphiques le graphique de filtre à utiliser.

Syntaxe

HRESULT SetFiltergraph(
  [in] IGraphBuilder *pfg
);

Paramètres

[in] pfg

Pointeur vers une interface IGraphBuilder qui spécifie le graphique de filtre à utiliser pour les appels suivants à la méthode IFilterGraph ::AddFilter .

Valeur retournée

Retourne une valeur HRESULT .

Remarques

Le générateur de graphiques crée automatiquement un graphique de filtre si vous n’appelez pas cette méthode. Si vous appelez cette méthode après que le générateur de graphiques a créé son propre graphique de filtre, l’appel échoue.

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

ICaptureGraphBuilder, interface