NdisUnbindAdapter 函数 (ndis.h)
协议驱动程序调用 NdisUnbindAdapter 函数以请求 NDIS 关闭与基础微型端口适配器的绑定。
语法
NDIS_STATUS NdisUnbindAdapter(
[in] NDIS_HANDLE NdisBindingHandle
);
参数
[in] NdisBindingHandle
协议驱动程序从调用 NdisOpenAdapterEx 函数获取的句柄。 句柄标识要关闭的绑定。
返回值
NdisUnbindAdapter 返回以下状态值之一:
返回代码 | 说明 |
---|---|
|
NdisUnbindAdapter 已成功启动取消绑定操作。 |
|
NdisUnbindAdapter 由于资源不足而失败。 |
注解
协议驱动程序在 ProtocolUnbindAdapterEx 或 ProtocolBindAdapterEx 函数的上下文外部调用 NdisUnbindAdapter。 NDIS 计划一个工作项来调用协议驱动程序的 ProtocolUnbindAdapterEx 函数并立即返回。
在对 NdisUnbindAdapter 的调用返回之前,NDIS 已关闭绑定。 因此,调用返回后,调用方不得假定它传递给 NdisBindingHandle 参数的句柄仍然有效。
注意 即使 NdisUnbindAdapter 返回NDIS_STATUS_SUCCESS,NDIS 也可能不会调用 ProtocolUnbindAdapterEx 。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 NDIS 6.0 及更高版本中受支持。 |
目标平台 | 桌面 |
标头 | ndis.h (包括 Ndis.h) |
Library | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 符合性规则 | Irql_Protocol_Driver_Function (ndis) |