Fungsi BdaInitFilter (bdasup.h)

  • Artikel

Fungsi BdaInitFilter menginisialisasi konteks filter BDA yang terkait dengan instans filter.

Sintaks

NTSTATUS BdaInitFilter(
  [in] PKSFILTER                 pKSFilter,
  [in] const BDA_FILTER_TEMPLATE *pBdaFilterTemplate
);

Parameter

[in] pKSFilter

Menunjuk ke filter untuk menginisialisasi konteks filter BDA.

[in] pBdaFilterTemplate

Menunjuk ke struktur BDA_FILTER_TEMPLATE yang menjelaskan templat filter untuk perangkat BDA. Untuk menentukan topologi untuk dan mengonfigurasi filter yang diinisialisasi, penyedia jaringan menggunakan informasi yang dirujuk dalam struktur BDA_FILTER_TEMPLATE ini.

Mengembalikan nilai

Mengembalikan STATUS_SUCCESS atau kode kesalahan yang sesuai.

Keterangan

Minidriver BDA memanggil fungsi BdaInitFilter untuk menginisialisasi instans filter menggunakan templat filter BDA tertentu dan pabrik filter yang sebelumnya dibuat melalui panggilan ke fungsi BdaCreateFilterFactory . Minidriver BDA kemudian dapat menggunakan instans filter ini dalam panggilan ke fungsi dukungan BDA lainnya, seperti, BdaCreatePin.

Ketika minidriver BDA memanggil BdaInitFilter, driver dukungan BDA (Bdasup.sys) membuat konteks filter BDA sendiri. Konteks filter BDA ini disembunyikan dari minidriver BDA. Namun, jika diperlukan, driver dukungan BDA dapat mengakses konteks filter BDA ini. Driver dukungan BDA menambahkan penunjuk ke konteks filter BDA ini ke tas objek untuk objek KSFILTER terkait. Ketika objek KSFILTER terkait dihancurkan, AVStream meminta agar driver dukungan BDA menghapus konteks filter BDA ini dari tas objek. Dengan cara ini, driver dukungan BDA dapat menghancurkan konteks filter BDA ini tanpa memerlukan intervensi oleh minidriver BDA.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Microsoft Windows XP dan sistem operasi yang lebih baru. Rutinitas ini tersedia di platform Windows 2000 hanya jika Microsoft DirectX 9.0 dan yang lebih baru diinstal pada platform tersebut.
Target Platform Desktop
Header bdasup.h (termasuk Bdasup.h)
Pustaka Bdasup.lib
IRQL PASSIVE_LEVEL

Lihat juga

BDA_FILTER_TEMPLATE

BdaCreateFilterFactory

BdaCreatePin

KSFILTER