Share via

Fungsi NdisIMGetDeviceContext (ndis.h)

  • Artikel

Catatan NDIS 5. x telah ditolak 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.

Fungsi ini memungkinkan fungsi MiniportInitialize driver menengah NDIS untuk mengakses area konteks perangkat yang dialokasikan oleh fungsi ProtocolBindAdapter-nya .

Sintaks

NDIS_HANDLE NdisIMGetDeviceContext(
  [in] NDIS_HANDLE MiniportAdapterHandle
);

Parameter

[in] MiniportAdapterHandle

Menentukan input handel ke MiniportInitialize.

Nilai kembali

Tabel berikut ini memperlihatkan nilai yang dikembalikan untuk fungsi ini.

Nilai Deskripsi
NDISIMGETDEVICECONTEXT Mengembalikan akses ke area konteks perangkat untuk NIC virtual yang diidentifikasi oleh MiniportAdapterHandle.
NULL Jika fungsi ProtocolBindAdapter driver tidak mengalokasikan area konteks perangkat tersebut.

Keterangan

Fungsi MiniportInitialize driver menengah NDIS memanggil NdisIMGetDeviceContext untuk mengakses area konteks perangkat untuk NIC virtual yang diinisialisasinya. Biasanya, memori untuk area tersebut disediakan oleh fungsi ProtocolBindAdapter driver menengah, yang memanggil NdisIMInitializeDeviceInstanceEx dengan penunjuk ke area ini, sehingga menyebabkan fungsi MiniportInitialize driver dipanggil. Namun, driver perantara tidak diharuskan memiliki area konteks seperti itu.

Saat kembali dari NdisIMGetDeviceContext, MiniportInitialize menyiapkan status yang ditentukan driver untuk NIC virtual dengan informasi apa pun yang ingin berguna bagi penulis driver perantara untuk tetap memiliki protokol tingkat yang lebih tinggi yang mengikat diri mereka sendiri kemudian ke NIC virtualnya.

Protokol NDIS tingkat yang masih lebih tinggi yang terikat ke NIC virtual yang sama kemudian dapat mengakses area konteks perangkat ini dengan memanggil NdisIMGetBindingContext dari fungsi ProtocolBindAdapter mereka.

Versi OS: Windows CE .NET 4.0 dan yang lebih baru.

Persyaratan

Persyaratan Nilai
Header ndis.h
Pustaka Ndis.lib
IRQL IRQL <= DISPATCH_LEVEL

Lihat juga