Méthode CBaseFilter.JoinFilterGraph

[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.]

La JoinFilterGraph méthode informe le filtre qu’il a joint ou quitté un graphique de filtre. Cette méthode implémente la méthode IBaseFilter::JoinFilterGraph .

Syntaxe

HRESULT JoinFilterGraph(
       IFilterGraph *pGraph,
  [in] LPCWSTR      pName
);

Paramètres

pGraph

Pointeur vers l’interface IFilterGraph du gestionnaire de graphe de filtres ou NULL si le filtre quitte le graphe.

pName [in]

Pointeur vers une chaîne Unicode contenant un nom pour le filtre.

Valeur renvoyée

Retourne S_OK.

Notes

Cette méthode définit la variable membre CBaseFilter::m_pGraph égale au paramètre pGraph . Il interroge également un pointeur d’interface IMediaEventSink et le stocke dans la variable membre CBaseFilter::m_pSink . Toutefois, le filtre ne conserve pas de nombre de références sur l’une ou l’autre de ces interfaces. Cela créerait un nombre de références circulaires, car le gestionnaire de graphiques de filtres conserve un nombre de références sur le filtre.

La méthode copie la chaîne spécifiée par pName dans la variable membre CBaseFilter::m_pName .

Configuration requise

Voir aussi

CBaseFilter, classe