Fungsi BdaMethodCreateTopology (bdasup.h)

Artikel
02/26/2024

Fungsi BdaMethodCreateTopology membuat topologi templat di antara dua pin filter.

Sintaks

NTSTATUS BdaMethodCreateTopology(
  [in]       PIRP      pIrp,
  [in]       PKSMETHOD pKSMethod,
  [optional] PVOID     pvIgnored
);

Parameter

[in] pIrp

Menunjuk ke IRP agar permintaan membuat topologi. Minidriver BDA menerima IRP ini dengan permintaan KSMETHOD_BDA_CREATE_TOPOLOGY .

[in] pKSMethod

Menunjuk ke struktur KSMETHOD yang menjelaskan metode dan jenis permintaan permintaan metode.

[optional] pvIgnored

Menunjuk ke buffer yang diabaikan.

Menampilkan nilai

Mengembalikan STATUS_SUCCESS atau kode kesalahan yang sesuai.

Keterangan

Minidriver BDA memanggil fungsi BdaMethodCreateTopology untuk membuat topologi templat di antara dua pin filter setelah minidriver menerima permintaan KSMETHOD_BDA_CREATE_TOPOLOGY dari metode KSMETHODSETID_BdaDeviceConfiguration yang ditetapkan dari penyedia jaringan. Sebagian besar minidriver BDA dapat menentukan tabel pengiriman dan otomatisasi filter sehingga minidriver tersebut mengirimkan fungsi BdaMethodCreateTopology secara langsung. Beberapa minidriver BDA harus mencegat permintaan ini, menggunakan metode internal (KStrMethodHandler), daripada mengirimkannya secara langsung. Mindriver ini harus mendapatkan penunjuk ke filter BDA dari IRP yang diteruskan sebelum memanggil BdaMethodCreateTopology sehingga mereka dapat menggunakan filter untuk melacak pin terkait. Mindriver ini kemudian dapat mengirim instruksi ke perangkat keras saat menyambungkan jenis pin tertentu. Lihat Menentukan Tabel Automation dan Mengonfigurasi Filter BDA untuk informasi selengkapnya.

Jika minidriver BDA harus membuat topologi templat di antara dua pin filter tanpa mengandalkan penyedia jaringan, minidriver BDA harus memanggil fungsi BdaCreateTopology .