Metode CBaseFilter.JoinFilterGraph
[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine , dan Pengambilan Audio/Video di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]
Metode ini JoinFilterGraph memberi tahu filter bahwa filter telah bergabung atau meninggalkan grafik filter. Metode ini mengimplementasikan metode IBaseFilter::JoinFilterGraph .
Sintaks
HRESULT JoinFilterGraph(
IFilterGraph *pGraph,
[in] LPCWSTR pName
);
Parameter
-
pGraph
-
Arahkan ke antarmuka IFilterGraph manajer grafik filter, atau NULL jika filter meninggalkan grafik.
-
pName [in]
-
Penunjuk ke string Unicode yang berisi nama untuk filter.
Nilai kembali
Mengembalikan S_OK.
Keterangan
Metode ini mengatur variabel anggota CBaseFilter::m_pGraph sama dengan parameter pGraph . Ini juga mengkueri penunjuk antarmuka IMediaEventSink dan menyimpannya di variabel anggota CBaseFilter::m_pSink . Namun, filter tidak menyimpan jumlah referensi pada salah satu antarmuka ini. Melakukannya akan membuat jumlah referensi melingkar, karena manajer grafik filter menyimpan jumlah referensi pada filter.
Metode menyalin string yang ditentukan oleh pName ke dalam variabel anggota CBaseFilter::m_pName .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header |
|
| Pustaka |
|