NdisIMGetBindingContext 函数 (ndis.h)
NdisIMGetBindingContext 函数允许 NDIS 协议驱动程序访问由基础中间驱动程序创建的虚拟微型端口的设备上下文区域,该上下文区域由更高级别的协议驱动程序绑定到的虚拟微型端口。
语法
NDIS_HANDLE NdisIMGetBindingContext(
[in] NDIS_HANDLE NdisBindingHandle
);
参数
[in] NdisBindingHandle
NdisOpenAdapterEx 函数在 NdisBindingHandle 参数处返回的绑定句柄,该参数标识调用方绑定到的下一个较低中间驱动程序的虚拟微型端口。
返回值
NdisIMGetBindingContext 返回给定虚拟微型端口的设备上下文区域的句柄;如果不存在此类上下文区域,则返回 NULL 。
注解
协议驱动程序或中间驱动程序可以从其 ProtocolBindAdapterEx 函数调用 NdisIMGetBindingContext,以访问它绑定到的虚拟微型端口的设备上下文。 设备上下文为绑定到同一基础中间驱动程序的所有过度协议驱动程序提供通用上下文区域。
此类设备上下文区域由较低级别的 NDIS 中间驱动程序分配和定义,并在调用 中传递给 NDIS NdisIMInitializeDeviceInstanceEx 函数。
调用 NdisIMGetBindingContext 的所有协议驱动程序都可以安全地假定基础中间驱动程序从非分页池分配了其上下文区域。 它们应将返回的上下文区域视为只读区域,并保留由定义它的基础 NDIS 中间驱动程序设置的状态。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | NDIS 6.0 和 NDIS 5.1 驱动程序支持 (请参阅 Windows Vista 中的 NdisIMGetBindingContext (NDIS 5.1) ) 。 NDIS 5.1 驱动程序支持 (请参阅 Windows XP 中的 NdisIMGetBindingContext (NDIS 5.1) ) 。 |
目标平台 | 桌面 |
标头 | ndis.h (包括 Ndis.h) |
Library | Ndis.lib |
IRQL | < DISPATCH_LEVEL |
DDI 符合性规则 | Irql_IM_Function (ndis) |