Share via

Fungsi NdisGetRoutineAddress (ndis.h)

  • Artikel

Fungsi NdisGetRoutineAddress mengembalikan alamat rutinitas dengan nama rutin.

Sintaks

PVOID NdisGetRoutineAddress(
  [in] PNDIS_STRING NdisRoutineName
);

Parameter

[in] NdisRoutineName

Penunjuk ke struktur UNICODE_STRING yang menentukan string yang berisi nama rutinitas.

Nilai kembali

Mengembalikan alamat rutin yang namanya ditentukan di NdisRoutineName jika rutinitas tersedia; jika tidak, NULL.

Keterangan

Driver NDIS dapat menggunakan NdisGetRoutineAddress untuk mendapatkan alamat rutinitas NDIS yang diekspor. Driver kemudian dapat menggunakan alamat ini untuk memanggil rutinitas NDIS.

Driver NDIS dapat menggunakan NdisGetRoutineAddress jika driver harus tetap kompatibel mundur. Misalnya, jika driver seperti itu mengimpor rutinitas NDIS yang tidak diekspor oleh versi NDIS yang saat ini berjalan, manajer I/O tidak akan memuat driver pada sistem operasi. Namun, driver pertama-tama dapat menggunakan NdisGetRoutineAddress untuk menentukan apakah rutinitas tersedia dalam versi NDIS yang saat ini berjalan. Jika tersedia, alamat rutinitas dikembalikan. Driver kemudian dapat menggunakan alamat untuk memanggil rutinitas. Jika tidak tersedia, NULL dikembalikan. Driver tidak dapat memanggil rutinitas, tetapi driver masih dimuat pada sistem operasi.

Tidak ada peningkatan performa yang diperoleh dengan menggunakan alamat yang dikembalikan oleh NdisGetRoutineAddress alih-alih memanggil rutinitas yang ditentukan berdasarkan nama. Oleh karena itu, jangan menulis driver NDIS untuk menggunakan NdisGetRoutineAddress jika Anda tahu bahwa versi NDIS yang akan dijalankan driver mengekspor rutinitas yang ditentukan.

Biasanya, driver NDIS memanggil NdisGetRoutineAddress dalam rutinitas DriverEntry-nya .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Didukung untuk driver NDIS 6.0 dan NDIS 5.1 (lihat NdisGetRoutineAddress (NDIS 5.1)) di Windows Vista. Didukung untuk driver NDIS 5.1 (lihat NdisGetRoutineAddress (NDIS 5.1)) di Windows XP.
Target Platform Universal
Header ndis.h (termasuk Ndis.h)
Pustaka Ndis.lib
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI Irql_Miscellaneous_Function(ndis)

Lihat juga

DriverEntry

UNICODE_STRING