Metode IGraphConfig::RemoveFilterEx (strmif.h)

Artikel
07/28/2023

[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

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka IGraphConfig

Bagikan melalui