Fungsi BdaCreateFilterFactory (bdasup.h)

Artikel
03/08/2023

Fungsi BdaCreateFilterFactory menambahkan deskriptor filter yang ditentukan sebagai pabrik filter ke perangkat yang ditentukan dan mengaitkan pabrik filter dengan topologi templat BDA yang ditentukan.

Sintaks

NTSTATUS BdaCreateFilterFactory(
  [in] PKSDEVICE                 pKSDevice,
  [in] const KSFILTER_DESCRIPTOR *pFilterDescriptor,
  [in] const BDA_FILTER_TEMPLATE *pBdaFilterTemplate
);

Parameter

[in] pKSDevice

Menunjuk ke perangkat BDA tempat menambahkan pabrik filter dengan topologi templat BDA terkait.

[in] pFilterDescriptor

Menunjuk ke struktur KSFILTER_DESCRIPTOR yang menjelaskan filter untuk perangkat BDA. Perhatikan bahwa tidak semua jenis pin templat dan node dapat diekspos sebagai pabrik pin dan node saat filter pertama kali diinisialisasi.

[in] pBdaFilterTemplate

Menunjuk ke struktur BDA_FILTER_TEMPLATE yang menjelaskan topologi templat BDA.

Mengembalikan nilai

Mengembalikan STATUS_SUCCESS atau kode kesalahan yang sesuai.

Keterangan

Minidriver BDA memanggil fungsi BdaCreateFilterFactory untuk menambahkan pabrik filter dengan topologi templat BDA terkait ke perangkat dan untuk mendaftarkan semua struktur templat statis topologi dengan pustaka dukungan BDA (BdaSup.sys). Pustaka dukungan BDA kemudian dapat menangani metode dan panggilan properti berikut:

Jika minidriver BDA memerlukan penunjuk ke pabrik filter yang baru dibuat (KSFILTERFACTORY), minidriver harus memanggil fungsi BdaCreateFilterFactoryEx sebagai gantinya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Microsoft Windows XP dan sistem operasi yang lebih baru.
Target Platform	Desktop
Header	bdasup.h (termasuk Bdasup.h)
Pustaka	Bdasup.lib
IRQL	PASSIVE_LEVEL