Metode IGraphConfig::RemoveFilterEx (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 RemoveFilterEx menghapus filter dari grafik filter.
Sintaks
HRESULT RemoveFilterEx(
[in] IBaseFilter *pFilter,
[in] DWORD Flags
);
Parameter
[in] pFilter
Arahkan ke antarmuka IBaseFilter filter untuk dihapus dari grafik.
[in] Flags
Kombinasi bendera dari jenis enumerasi REM_FILTER_FLAGS .
Mengembalikan nilai
Mengembalikan S_OK jika berhasil, atau nilai HRESULT yang menunjukkan penyebab kegagalan.
Keterangan
Metode ini memperluas metode IFilterGraph::RemoveFilter dengan menerima bendera yang menentukan perilaku metode . Bendera ini memungkinkan aplikasi untuk menghapus filter tanpa memutuskan pin secara otomatis, yang meningkatkan performa saat memindahkan grup filter yang terhubung ke grafik baru.
Secara default, metode ini memutuskan sambungan filter sebelum menghapusnya dari grafik. Gunakan bendera REMFILTERF_LEAVECONNECTED untuk membiarkan filter tersambung.
Persyaratan
| 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 |