Struktur REGFILTERPINS (strmif.h)

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan 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 Pengambilan Audio/Video 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 REGFILTERPINS berisi informasi pin untuk mendaftarkan filter.

Sintaks

typedef struct REGFILTERPINS {
  LPWSTR            strName;
  BOOL              bRendered;
  BOOL              bOutput;
  BOOL              bZero;
  BOOL              bMany;
  const CLSID       *clsConnectsToFilter;
  const WCHAR       *strConnectsToPin;
  UINT              nMediaTypes;
  const REGPINTYPES *lpMediaType;
} REGFILTERPINS;

Anggota

strName

Nama pin. (Usang.)

bRendered

Jika TRUE, filter merender input dari pin ini. (Hanya berlaku untuk pin input. Untuk pin output, nilainya selalu FALSE.)

bOutput

Jika TRUE, pin ini adalah pin output. Jika tidak, pin adalah pin input.

bZero

Jika TRUE, filter dapat memiliki nol instans pin ini.

bMany

Jika TRUE, filter dapat membuat lebih dari satu instans jenis pin ini.

clsConnectsToFilter

Pengidentifikasi kelas (CLSID) filter tempat pin ini terhubung. (Usang.)

strConnectsToPin

Nama pin yang disambungkan oleh pin ini. (Usang.)

nMediaTypes

Jumlah tipe media yang didukung oleh pin ini.

lpMediaType

Penunjuk ke array struktur REGPINTYPES , dari ukuran nMediaTypes.

Keterangan

Struktur ini digunakan dalam antarmuka IFilterMapper2 untuk pendaftaran filter. Jika Anda menggunakan struktur ini, atur anggota dwVersion dari struktur REGFILTER2 ke 1. Jika Anda perlu mendaftarkan kategori sedang atau pin untuk pin, gunakan struktur REGFILTERPINS2 sebagai gantinya. Dalam hal ini, atur anggota dwVersion struktur REGFILTER2 ke 2.

Jenis AMOVIESETUP_PIN yang setara digunakan dalam templat pabrik kelas (CFactoryTemplate).

Anggota strName, clsConnectsToFilter, dan strConnectsToPin sudah usang. Nilainya tidak ditambahkan ke registri.

Untuk informasi selengkapnya, lihat Cara Mendaftarkan Filter DirectShow.

Persyaratan

Lihat juga

Struktur DirectShow