struktur REGFILTER2 (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.]

Struktur REGFILTER2 berisi informasi untuk mendaftarkan filter.

Sintaks

typedef struct REGFILTER2 {
  DWORD dwVersion;
  DWORD dwMerit;
  union {
    struct {
      ULONG               cPins;
      const REGFILTERPINS *rgPins;
    } DUMMYSTRUCTNAME;
    struct {
      ULONG                cPins2;
      const REGFILTERPINS2 *rgPins2;
    } DUMMYSTRUCTNAME2;
  } DUMMYUNIONNAME;
} REGFILTER2;

Anggota

dwVersion

Filter format pendaftaran. Jika nilainya adalah 1, gabungan berisi struktur pertama yang tidak disebutkan namanya. Jika nilainya adalah 2, gabungan berisi struktur kedua yang tidak disebutkan namanya.

dwMerit

Filter berjasa. Filter dengan manfaat yang lebih tinggi dijumlahkan terlebih dahulu. Lihat Merit.

DUMMYUNIONNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.cPins

DUMMYUNIONNAME.DUMMYSTRUCTNAME.rgPins

DUMMYUNIONNAME.DUMMYSTRUCTNAME2

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.cPins2

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.rgPins2

Keterangan

Struktur ini diteruskan ke metode IFilterMapper2::RegisterFilter .

Jika Anda perlu mendaftarkan media pin atau kategori pin, atur dwVersion ke 2 dan gunakan struktur REGFILTERPINS2 .

Persyaratan

Persyaratan	Nilai
Header	strmif.h (termasuk Dshow.h)

Lihat juga

Struktur DirectShow