Metode IFilterChain::RemoveChain (strmif.h)
[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Tangkapan 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 Audio/Video Capture 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 RemoveChain menghapus setiap filter dalam rantai filter dari grafik filter.
Sintaks
HRESULT RemoveChain(
[in] IBaseFilter *pStartFilter,
[in] IBaseFilter *pEndFilter
);
Parameter
[in] pStartFilter
Penunjuk ke antarmuka IBaseFilter filter di awal rantai.
[in] pEndFilter
Penunjuk ke antarmuka IBaseFilter filter di akhir rantai. Jika parameter ini ADALAH NULL, metode menggunakan rantai filter terpanjang yang memperluas hilir dari filter mulai.
Nilai kembali
Mengembalikan S_OK jika berhasil, atau nilai HRESULT yang menunjukkan penyebab kegagalan sebaliknya.
Keterangan
Anda dapat memanggil metode ini saat grafik sedang berjalan; metode menghentikan filter dalam rantai sebelum menghapusnya dari grafik.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | strmif.h (termasuk Dshow.h) |
| Pustaka | Strmiids.lib |