NdisIMGetBindingContext 函数 (ndis.h)

NdisIMGetBindingContext 函数允许 NDIS 协议驱动程序访问由基础中间驱动程序创建的设备上下文区域,该区域是高级协议驱动程序绑定到的虚拟微型端口。

语法

NDIS_HANDLE NdisIMGetBindingContext(
  [in] NDIS_HANDLE NdisBindingHandle
);

参数

[in] NdisBindingHandle

NdisOpenAdapterEx 函数在 NdisBindingHandle 参数返回的绑定句柄,该参数标识调用方绑定到的下一个中级驱动程序的虚拟微型端口。

返回值

NdisIMGetBindingContext 返回给定虚拟微型端口的设备上下文区域的句柄,或者如果不存在此类上下文区域,则返回 NULL

言论

协议驱动程序或中间驱动程序可以从其 ProtocolBindAdapterEx 函数调用 NdisIMGetBindingContext,以访问它绑定到的虚拟微型端口的设备上下文。 设备上下文为绑定到同一基础中间驱动程序的所有过度协议驱动程序提供了一个通用上下文区域。

此类设备上下文区域由较低级别的 NDIS 中间驱动程序分配和定义,并在调用 NDIS 时传递给 NDIS NdisIMInitializeDeviceInstanceEx 函数。

调用 NdisIMGetBindingContext 的所有协议驱动程序 可以安全地假定基础中间驱动程序从非分页池分配了其上下文区域。 它们应将返回的上下文区域视为只读,并保留由定义它的基础 NDIS 中间驱动程序设置的状态。

要求

要求 价值
最低支持的客户端 Windows Vista 中支持 NDIS 6.0 和 NDIS 5.1 驱动程序(请参阅 NdisIMGetBindingContext (NDIS 5.1) 。 支持 NDIS 5.1 驱动程序(请参阅 Windows XP 中的 NdisIMGetBindingContext (NDIS 5.1) 。
目标平台 桌面
标头 ndis.h (包括 Ndis.h)
Ndis.lib
IRQL < DISPATCH_LEVEL
DDI 符合性规则 Irql_IM_Function(ndis)

另请参阅

NdisIMInitializeDeviceInstanceEx

NdisOpenAdapterEx

ProtocolBindAdapterEx