Makro NdisMInitializeWrapper (ndis.h)

Artikel
08/07/2023

Catatan NDIS 5. x telah tidak digunakan lagi dan digantikan oleh NDIS 6. x. Untuk pengembangan driver NDIS baru, lihat Driver Jaringan Yang Dimulai dengan Windows Vista. Untuk informasi tentang port NDIS 5. x driver ke NDIS 6. x, lihat Memindahkan Driver NDIS 5.x ke NDIS 6.0.

NdisMInitializeWrapper memberi tahu NDIS bahwa driver miniport baru sedang diinisialisasi.

Sintaks

VOID NdisInitializeWrapper(
  _Out_ PNDIS_HANDLE  NdisWrapperHandle,
  _In_ PVOID SystemSpecific1,
  _In_ PVOID SystemSpecific2,
  _In_ PVOID SystemSpecific3
);

Parameter

[out] _a

Penunjuk ke variabel yang disediakan penelepon di mana NDIS mengembalikan handel yang mewakili dirinya sendiri. Jika panggilan ke NdisMInitializeWrapper gagal, NDIS mengatur variabel di NdisWrapperHandle ke NULL.

[in] _b

Menentukan penunjuk dari jenis khusus sistem.

Untuk driver Windows 2000 dan yang lebih baru, ini adalah penunjuk ke input objek driver buram ke fungsi DriverEntry driver miniport.

[in] _c

Menentukan penunjuk dari jenis khusus sistem.

Untuk driver Windows 2000 dan yang lebih baru, ini adalah penunjuk ke input jalur registri buram ke fungsi DriverEntry driver miniport.

[in] _d

Menentukan penunjuk dari jenis khusus sistem.

Untuk driver Windows 2000 dan yang lebih baru, pointer ini harus diatur ke NULL ketika driver miniport memanggil NdisMInitializeWrapper.

Nilai kembali

Tidak ada

Keterangan

Driver NIC atau driver perantara harus memanggil NdisMInitializeWrapper sebelum memanggil fungsi NdisXxx lainnya. Biasanya, panggilan ini adalah tindakan awal dari setiap fungsi DriverEntry driver NIC, yang memanggil NdisMRegisterMiniport atau NdisIMRegisterLayeredMiniport dengan NdisWrapperHandle yang dikembalikan berikutnya. Driver perantara NDIS juga harus memanggil NdisMInitializeWrapper dari fungsi DriverEntry dan, kemudian, memanggil NdisMRegisterMiniport atau NdisIMRegisterLayeredMiniport dengan NdisWrapperHandle yang dikembalikan.

Panggilan berikutnya driver ke fungsi inisialisasi dan konfigurasi NdisXxx harus melewati NdisWrapperHandle sebagai parameter. Akibatnya, ini adalah parameter input ke fungsi MiniportInitialize .

Jika panggilan ke NdisMInitializeWrapper gagal, NDIS mengatur variabel di NdisWrapperHandle ke NULL. Driver harus selalu memeriksa nilai variabel ini setelah NdisMInitializeWrapper kembali. Jika nilainya NULL, driver harus gagal dalam panggilan ke fungsi DriverEntry .