Metode IFilterMapper2::UnregisterFilter (strmif.h)

Artikel
07/28/2023

[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 ini UnregisterFilter menghapus informasi filter dari registri.

Sintaks

HRESULT UnregisterFilter(
  [in] const CLSID *pclsidCategory,
  [in] LPCOLESTR   szInstance,
  [in] REFCLSID    Filter
);

Parameter

[in] pclsidCategory

Alamat GUID yang menentukan kategori filter untuk menghapus filter. Untuk daftar kategori, lihat Kategori Filter.

[in] szInstance

Data instans yang digunakan untuk membuat nama tampilan moniker perangkat. Gunakan nilai yang awalnya diteruskan ke metode RegisterFilter .

[in] Filter

Pengidentifikasi kelas (CLSID) filter.

Mengembalikan nilai

Mengembalikan S_OK jika berhasil, atau nilai HRESULT yang menunjukkan penyebab kesalahan.

Keterangan

Jika filter tidak terdaftar, metode mungkin mengembalikan kesalahan.

Persyaratan


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