CBaseFilter.JoinFilterGraph-Methode

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die JoinFilterGraph -Methode benachrichtigt den Filter darüber, dass sie ein Filterdiagramm verknüpft oder verlassen hat. Diese Methode implementiert die IBaseFilter::JoinFilterGraph-Methode .

Syntax

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

Parameter

pGraph

Zeiger auf die IFilterGraph-Schnittstelle des Filtergraph-Managers oder NULL , wenn der Filter das Diagramm verlässt.

pName [in]

Zeiger auf eine Unicode-Zeichenfolge, die einen Namen für den Filter enthält.

Rückgabewert

Gibt S_OK zurück.

Bemerkungen

Diese Methode legt die CBaseFilter::m_pGraph Membervariable gleich dem pGraph-Parameter fest. Außerdem wird ein IMediaEventSink-Schnittstellenzeiger abfragen und in der Membervariable cBaseFilter::m_pSink gespeichert. Der Filter behält jedoch keine Referenzanzahl auf einer dieser Schnittstellen bei. Dadurch wird eine kreisförmige Verweisanzahl erstellt, da der Filterdiagramm-Manager eine Verweisanzahl für den Filter behält.

Die -Methode kopiert die von pName angegebene Zeichenfolge in die Membervariable CBaseFilter::m_pName .

Anforderungen

Siehe auch

CBaseFilter-Klasse