Metode IFilterMapper2::CreateCategory (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.]

Metode menambahkan CreateCategory kategori filter baru ke registri.

Sintaks

HRESULT CreateCategory(
  [in] REFCLSID clsidCategory,
  [in] DWORD    dwCategoryMerit,
  [in] LPCWSTR  Description
);

Parameter

[in] clsidCategory

Pengidentifikasi kelas (CLSID) dari kategori filter baru.

[in] dwCategoryMerit

Manfaat kategori. Kategori dengan manfaat yang lebih tinggi dijumlahkan terlebih dahulu.

[in] Description

Nama deskriptif untuk kategori.

Nilai kembali

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

Keterangan

Manajer grafik filter awalnya melewati semua kategori dengan nilai merit kurang dari atau sama dengan MERIT_DO_NOT_USE, untuk mempercepat proses pembuatan grafik. Kategori filter yang tidak boleh dipertimbangkan untuk pemutaran harus memiliki manfaat MERIT_DO_NOT_USE atau kurang.

Filter dapat muncul dalam satu atau beberapa kategori (misalnya, Kompresor Video) untuk membatasi ruang pencarian.

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