Bagikan melalui

Metode IGraphConfig::SetFilterFlags (strmif.h)

  • Artikel

[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