Fungsi NdisRegisterProtocolDriver (ndis.h)

  • Artikel

Driver protokol memanggil fungsi NdisRegisterProtocolDriver untuk mendaftarkan fungsi ProtocolXxx dengan NDIS.

Sintaks

NDIS_STATUS NdisRegisterProtocolDriver(
  [in, optional] NDIS_HANDLE                           ProtocolDriverContext,
  [in]           PNDIS_PROTOCOL_DRIVER_CHARACTERISTICS ProtocolCharacteristics,
  [out]          PNDIS_HANDLE                          NdisProtocolHandle
);

Parameter

[in, optional] ProtocolDriverContext

Handel ke area konteks yang dialokasikan driver tempat driver mempertahankan informasi status dan konfigurasi.

[in] ProtocolCharacteristics

Penunjuk ke NDIS_PROTOCOL_DRIVER_CHARACTERISTICS struktur yang dibuat dan diinisialisasi driver protokol dengan titik entri fungsi ProtocolXxx .

[out] NdisProtocolHandle

Penunjuk ke variabel handel yang disediakan penelepon. NDIS menulis handel ke variabel ini yang secara unik mengidentifikasi driver yang mendaftar. Driver harus menyimpan handel ini untuk digunakan dalam panggilan fungsi NdisXxx berikutnya.

Nilai kembali

NdisRegisterProtocolDriver mengembalikan salah satu nilai status berikut:

Menampilkan kode Deskripsi
NDIS_STATUS_SUCCESS

NdisRegisterProtocolDriver mengembalikan NDIS_STATUS_SUCCESS jika mendaftarkan driver protokol.
NDIS_STATUS_BAD_VERSION
 Versi yang ditentukan dalam anggota MajorNdisVersion dari struktur di ProtocolCharacteristics tidak valid.
NDIS_STATUS_BAD_CHARACTERISTICS
 Beberapa anggota struktur di parameter ProtocolCharacteristics tidak valid.
NDIS_STATUS_RESOURCES

NdisRegisterProtocolDriver gagal karena sumber daya yang tidak mencukupi.
NDIS_STATUS_FAILURE

NdisRegisterProtocolDriver mengembalikan NDIS_STATUS_FAILURE jika tidak ada nilai sebelumnya yang berlaku.

Keterangan

Driver protokol memanggil fungsi NdisRegisterProtocolDriver dari rutinitas DriverEntry-nya . Untuk informasi selengkapnya tentang DriverEntry, lihat DriverEntry driver protokol NDIS.

Driver yang memanggil NdisRegisterProtocolDriver harus siap untuk panggilan langsung ke salah satu fungsi ProtocolXxx mereka.

Setiap driver protokol mengekspor sekumpulan fungsi ProtocolXxx dengan menyiapkan NDIS_PROTOCOL_DRIVER_CHARACTERISTICS struktur dan panggilan NdisRegisterProtocolDriver. NDIS menyalin struktur ini ke penyimpanan internal pustaka NDIS.

Untuk mengizinkan driver protokol mendaftarkan layanan opsional, NDIS memanggil fungsi ProtocolSetOptions dalam konteks NdisRegisterProtocolDriver.

Driver protokol memanggil Fungsi NdisDeregisterProtocolDriver untuk merilis sumber daya yang sebelumnya dialokasikan dengan NdisRegisterProtocolDriver.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Didukung di NDIS 6.0 dan yang lebih baru.
Target Platform Desktop
Header ndis.h (termasuk Ndis.h)
Pustaka Ndis.lib
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI Irql_Protocol_Driver_Function(ndis)

Lihat juga

DriverEntry dari Driver Protokol NDIS

NDIS_PROTOCOL_DRIVER_CHARACTERISTICS

NdisDeregisterProtocolDriver

NdisSetOptionalHandlers