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
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|