Fungsi NdisMRegisterWdiMiniportDriver (dot11wdi.h)

Artikel
02/23/2024

Penting

Topik ini adalah bagian dari model driver WDI yang dirilis dalam Windows 10. Model driver WDI berada dalam mode pemeliharaan dan hanya akan menerima perbaikan prioritas tinggi. WiFiCx adalah model driver Wi-Fi yang dirilis dalam Windows 11. Kami menyarankan agar Anda menggunakan WiFiCx untuk memanfaatkan fitur terbaru.

Driver miniport memanggil fungsi NdisMRegisterWdiMiniportDriver untuk mendaftarkan titik masuk MiniportWdiXxx dengan NDIS sebagai langkah pertama dalam inisialisasi.

Sintaks

NDIS_EXPORTED_ROUTINE NDIS_STATUS NdisMRegisterWdiMiniportDriver(
  [in]           DRIVER_OBJECT                            *DriverObject,
  [in]           PCUNICODE_STRING                         RegistryPath,
  [in, optional] NDIS_MINIPORT_DRIVER_CONTEXT             NdisDriverContext,
  [in]           NDIS_MINIPORT_DRIVER_CHARACTERISTICS     *MiniportDriverCharacteristics,
  [in]           NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS *MiniportWdiCharacteristics,
  [out]          NDIS_MINIPORT_DRIVER_HANDLE              *NdisMiniportDriverHandle
);

Parameter

[in] DriverObject

Penunjuk ke objek driver buram yang diterima driver miniport dalam rutinitas DriverEntry-nya pada parameter Argument1 (lihat DriverEntry driver NDIS Miniport Drivers).

[in] RegistryPath

Penunjuk ke jalur registri buram yang diterima driver miniport dalam rutinitas DriverEntry-nya pada parameter Argument2 .

[in, optional] NdisDriverContext

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

[in] MiniportDriverCharacteristics

Penunjuk ke NDIS_MINIPORT_DRIVER_CHARACTERISTICS struktur yang diinisialisasi pemanggil.

[in] MiniportWdiCharacteristics

Penunjuk ke struktur NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS yang diinisialisasi pemanggil.

[out] NdisMiniportDriverHandle

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

Nilai kembali

NdisMRegisterWdiMiniportDriver dapat mengembalikan salah satu nilai pengembalian berikut.

Menampilkan kode	Deskripsi
NDIS_STATUS_SUCCESS	NdisMRegisterWdiMiniportDriver berhasil mendaftarkan driver miniport WDI.
NDIS_STATUS_BAD_CHARACTERISTICS	Parameter CharacteristicsLength salah untuk versi NDIS yang ditentukan pada anggota MajorNdisVersion dalam struktur di MiniportDriverCharacteristics .
NDIS_STATUS_BAD_VERSION	MajorNdisVersion atau MinorNdisVersion yang ditentukan dalam struktur karakteristik tidak valid.
NDIS_STATUS_RESOURCES	Kekurangan sumber daya, mungkin memori, mencegah NDIS mendaftarkan penelepon.
NDIS_STATUS_FAILURE	Ini adalah status kesalahan default, dikembalikan ketika tidak ada kesalahan sebelumnya yang menyebabkan pendaftaran gagal.
Kode NDIS_STATUS lainnya	Kode NDIS_STATUS yang sesuai jika terjadi kegagalan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10
Server minimum yang didukung	Server Windows 2016
Target Platform	Windows
Header	dot11wdi.h
Pustaka	Ndis.lib
IRQL	PASSIVE_LEVEL

Lihat juga

DRIVER_OBJECT

NDIS_MINIPORT_DRIVER_CHARACTERISTICS

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

Share via