IFilterMapper2::Metode RegisterFilter (strmif.h)

Artikel
03/04/2024

[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.]

Metode menambahkan RegisterFilter informasi filter ke registri.

Sintaks

HRESULT RegisterFilter(
  [in]      REFCLSID         clsidFilter,
  [in]      LPCWSTR          Name,
  [in, out] IMoniker         **ppMoniker,
  [in]      const CLSID      *pclsidCategory,
  [in]      LPCOLESTR        szInstance,
  [in]      const REGFILTER2 *prf2
);

Parameter

[in] clsidFilter

Pengidentifikasi kelas (CLSID) filter.

[in] Name

Nama deskriptif untuk filter.

[in, out] ppMoniker

Alamat penunjuk ke moniker perangkat yang menentukan di mana data filter ini akan ditulis. Bisa NULL.

[in] pclsidCategory

Penunjuk ke kategori filter filter. Jika NULL, kategori default adalah CLSID_ActiveMovieFilters. (Lihat Kategori Filter.)

[in] szInstance

Data instans untuk membuat nama tampilan moniker perangkat. Dapat berupa nama yang mudah diingat, atau representasi string dari filter CLSID. Jika NULL, default ke filter CLSID.

[in] prf2

Penunjuk ke struktur REGFILTER2 yang berisi informasi filter.

Mengembalikan nilai

Mengembalikan nilai HRESULT . Nilai yang mungkin termasuk yang diperlihatkan dalam tabel berikut ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
VFW_E_BAD_KEY	Tidak bisa mendapatkan kunci registri.

Keterangan

Metode ini menambahkan informasi tentang filter ke registri, di bawah entri registri untuk kategori filter yang ditentukan. Ini tidak mendaftarkan server dalam proses yang membuat filter (biasanya DLL). Untuk mendaftarkan server, Anda dapat memanggil fungsi AMovieDllRegisterServer2 .

Untuk parameter ppMoniker , gunakan salah satu hal berikut:

Alamat penunjuk antarmuka IMoniker untuk moniker perangkat yang ada
Alamat penunjuk antarmuka IMonikerNULL
NULL

Jika Anda mendaftarkan filter untuk Windows Driver Model (WDM) atau perangkat Plug and Play, teruskan alamat moniker perangkat yang ada. Filter akan didaftarkan menggunakan moniker ini. Ketika metode kembali, *ppMoniker diatur ke NULL.

Jika tidak, metode membuat moniker baru. Jika ppMonikernon-NULL, metode mengatur *ppMoniker untuk menunjuk ke moniker baru. Aplikasi dapat menggunakan moniker ini untuk menulis nilai privat tambahan di tas properti. Pastikan untuk merilis antarmuka.

Atur ppMoniker ke NULL jika Anda tidak ingin menyediakan atau menerima moniker.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	strmif.h (termasuk Dshow.h)
Pustaka	Strmiids.lib

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka IFilterMapper2

Bagikan melalui