NdisCloseAdapterEx 函数 (ndis.h)

  • 项目

协议驱动程序调用 NdisCloseAdapterEx 函数以释放绑定和驱动程序调用 NdisOpenAdapterEx 函数时分配的资源。

语法

NDIS_STATUS NdisCloseAdapterEx(
  [in] NDIS_HANDLE NdisBindingHandle
);

参数

[in] NdisBindingHandle

NDIS 在 NdisOpenAdapterEx 的 NdisBindingHandle 参数中提供的句柄。 此句柄标识 NDIS 应关闭的绑定。

返回值

NdisCloseAdapterEx 返回以下状态值之一：

返回代码 说明
NDIS_STATUS_SUCCESS
 NdisCloseAdapterEx 已成功关闭到基础微型端口适配器的绑定。
NDIS_STATUS_PENDING
 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)

另请参阅

NdisOpenAdapterEx

NdisUnbindAdapter

ProtocolBindAdapterEx

ProtocolCloseAdapterCompleteEx

ProtocolUnbindAdapterEx