Metode IGraphConfig::SetFilterFlags (strmif.h)

Artikel
03/04/2024

[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 SetFilterFlags menetapkan informasi konfigurasi filter.

Sintaks

HRESULT SetFilterFlags(
  [in] IBaseFilter *pFilter,
  [in] DWORD       dwFlags
);

Parameter

[in] pFilter

Penunjuk ke antarmuka IBaseFilter filter di grafik filter.

[in] dwFlags

Nilai yang menentukan bendera konfigurasi baru. Harus salah satu dari nilai berikut.

Nilai	Deskripsi
Nol	Tidak ada bendera yang ditetapkan.
AM_FILTER_FLAGS_REMOVABLE	Filter dapat dilepas selama koneksi ulang dinamis. Untuk informasi selengkapnya, lihat Keterangan.

Mengembalikan nilai

Mengembalikan salah satu nilai HRESULT berikut.

Menampilkan kode	Deskripsi
E_POINTER	Argumen penunjuk NULL.
E_INVALIDARG	Argumen tidak valid.
S_OK	Berhasil.
VFW_E_NOT_IN_GRAPH	Filter tidak ada dalam grafik.

Keterangan

Bendera AM_FILTER_FLAGS_REMOVABLE mengubah perilaku metode IGraphConfig::Reconnect . Metode Sambungkan kembali melakukan koneksi ulang dinamis di antara dua pin. Jika penelepon menentukan satu pin, tetapi membiarkan pin lain tidak ditentukan, Sambungkan kembali mencari upstram atau hilir dari pin yang ditentukan untuk menemukan kecocokan yang cocok. Namun, secara default, pencarian gagal jika mencapai filter yang ditambahkan ke grafik dengan metode IFilterGraph::AddFilter . Untuk mengambil alih perilaku ini, panggil SetFilterFlags dan atur bendera AM_FILTER_FLAGS_REMOVABLE pada filter.

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

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka IGraphConfig

Bagikan melalui