Metodo CBaseFilter.JoinFilterGraph

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il JoinFilterGraph metodo notifica al filtro che ha unito o lasciato un grafico di filtro. Questo metodo implementa il metodo IBaseFilter::JoinFilterGraph .

Sintassi

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

Parametri

pGraph

Puntatore all'interfaccia IFilterGraph di Gestione grafici del filtro oppure NULL se il filtro esce dal grafico.

pName [in]

Puntatore a una stringa Unicode contenente un nome per il filtro.

Valore restituito

Restituisce S_OK.

Commenti

Questo metodo imposta la variabile membro CBaseFilter::m_pGraph uguale al parametro pGraph . Esegue anche una query per un puntatore all'interfaccia IMediaEventSink e lo archivia nella variabile membro CBaseFilter::m_pSink . Tuttavia, il filtro non mantiene un conteggio dei riferimenti su una di queste interfacce. In questo modo si creerebbe un conteggio di riferimenti circolari, perché il gestore del grafo dei filtri mantiene un conteggio dei riferimenti sul filtro.

Il metodo copia la stringa specificata da pName nella variabile membro CBaseFilter::m_pName .

Requisiti

Requisito Valore
Intestazione
Amfilter.h (include Streams.h)
Libreria
Strmbase.lib (build retail);
Strmbasd.lib (build di debug)

Vedi anche

Classe CBaseFilter