Fungsi NdisIMGetBindingContext (ndis.h)

Fungsi NdisIMGetBindingContext memungkinkan driver protokol NDIS untuk mengakses area konteks perangkat, yang dibuat oleh driver perantara yang mendasar, untuk miniport virtual tempat driver protokol tingkat yang lebih tinggi terikat.

Sintaks

NDIS_HANDLE NdisIMGetBindingContext(
  [in] NDIS_HANDLE NdisBindingHandle
);

Parameter

[in] NdisBindingHandle

Handel pengikatan yang dikembalikan fungsi NdisOpenAdapterEx pada parameter NdisBindingHandle yang mengidentifikasi miniport virtual driver perantara bawah berikutnya yang terikat dengan pemanggil.

Nilai kembali

NdisIMGetBindingContext mengembalikan handel ke area konteks perangkat untuk miniport virtual tertentu, atau mengembalikan NULL jika tidak ada area konteks tersebut.

Keterangan

Driver protokol atau driver perantara dapat memanggil NdisIMGetBindingContext dari fungsi ProtocolBindAdapterEx untuk mengakses konteks perangkat untuk miniport virtual yang terikat. Konteks perangkat menyediakan area konteks umum untuk semua driver protokol yang terlalu berlebihan yang terikat ke driver perantara yang mendasar yang sama.

Area konteks perangkat tersebut dialokasikan dan didefinisikan oleh driver menengah NDIS tingkat bawah dan diteruskan ke NDIS dalam panggilan ke Fungsi NdisIMInitializeDeviceInstanceEx .

Semua driver protokol yang memanggil NdisIMGetBindingContext dapat dengan aman mengasumsikan bahwa driver perantara yang mendasar mengalokasikan area konteksnya dari kumpulan yang tidak dipagasi. Mereka harus memperlakukan area konteks yang dikembalikan sebagai baca-saja, mempertahankan status yang disiapkan oleh driver perantara NDIS yang mendasarinya yang mendefinisikannya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung untuk driver NDIS 6.0 dan NDIS 5.1 (lihat NdisIMGetBindingContext (NDIS 5.1)) di Windows Vista. Didukung untuk driver NDIS 5.1 (lihat NdisIMGetBindingContext (NDIS 5.1)) di Windows XP.
Target Platform	Desktop
Header	ndis.h (termasuk Ndis.h)
Pustaka	Ndis.lib
IRQL	< DISPATCH_LEVEL
Aturan kepatuhan DDI	Irql_IM_Function(ndis)

Lihat juga

NdisIMInitializeDeviceInstanceEx

NdisOpenAdapterEx

ProtocolBindAdapterEx