Fungsi BdaCreateFilterFactoryEx (bdasup.h)

Artikel
03/08/2023

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

Sintaks

NTSTATUS BdaCreateFilterFactoryEx(
  [in]            PKSDEVICE                 pKSDevice,
  [in]            const KSFILTER_DESCRIPTOR *pFilterDescriptor,
  [in]            const BDA_FILTER_TEMPLATE *pBdaFilterTemplate,
  [out, optional] PKSFILTERFACTORY          *ppKSFilterFactory
);

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 dan node templat 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.

[out, optional] ppKSFilterFactory

Menunjuk ke buffer yang menerima pointer ke struktur KSFILTERFACTORY untuk pabrik filter yang baru dibuat.

Mengembalikan nilai

Mengembalikan STATUS_SUCCESS atau kode kesalahan yang sesuai.

Keterangan

Minidriver BDA memanggil fungsi BdaCreateFilterFactoryEx 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:

Minidriver BDA memanggil BdaCreateFilterFactoryEx daripada fungsi BdaCreateFilterFactory setiap kali memerlukan pointer ke KSFILTERFACTORY yang baru dibuat. Fungsi BdaCreateFilterFactory juga membuat pabrik filter tetapi tidak mengembalikannya ke pemanggil. Minidriver BDA memerlukan penunjuk ke KSFILTERFACTORY yang baru dibuat jika minidriver harus memanggil fungsi _KsEdit untuk mengedit KSFILTERFACTORY.

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