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) |