NdisCloseAdapterEx 函数 (ndis.h)
协议驱动程序调用 NdisCloseAdapterEx 函数以释放绑定和驱动程序调用 NdisOpenAdapterEx 函数时分配的资源。
语法
NDIS_STATUS NdisCloseAdapterEx(
[in] NDIS_HANDLE NdisBindingHandle
);
参数
[in] NdisBindingHandle
NDIS 在 NdisOpenAdapterEx 的 NdisBindingHandle 参数中提供的句柄。 此句柄标识 NDIS 应关闭的绑定。
返回值
NdisCloseAdapterEx 返回以下状态值之一：
| 返回代码 | 说明 |
|---|---|
|
NdisCloseAdapterEx 已成功关闭到基础微型端口适配器的绑定。 |
|
NdisCloseAdapterEx 未完成关闭操作，操作将以异步方式完成。 NDIS 调用协议驱动程序的操作完成后的 ProtocolCloseAdapterCompleteEx 函数。 |
注解
协议驱动程序通常从其调用 NdisCloseAdapterEx ProtocolUnbindAdapterEx 函数。 驱动程序还可以从其 ProtocolBindAdapterEx 函数调用 NdisCloseAdapterEx。 例如，如果驱动程序在调用 NdisOpenAdapterEx 之后未能设置 OID 值，则可以从其 ProtocolBindAdapterEx 函数调用 NdisCloseAdapterEx。
如果协议驱动程序必须关闭 ProtocolUnbindAdapterEx 或 ProtocolBindAdapterEx 上下文之外的微型端口适配器，则必须调用 NdisUnbindAdapter 函数。
在调用 NdisCloseAdapterEx 之前，协议驱动程序应等待它们发起的所有发送请求和 OID 请求完成。
驱动程序调用 NdisCloseAdapterEx 后，从 NdisBindingHandle 参数的 NdisOpenAdapterEx 函数获取的句柄将变为无效。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 NDIS 6.0 及更高版本中受支持。 |
| 目标平台 | 桌面 |
| 标头 | ndis.h (包括 Ndis.h) |
| Library | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| DDI 符合性规则 | Irql_Protocol_Driver_Function (ndis) |