NdisCloseAdapterEx 函数 (ndis.h)

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

语法

NDIS_STATUS NdisCloseAdapterEx(
  [in] NDIS_HANDLE NdisBindingHandle
);

参数

[in] NdisBindingHandle

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

返回值

NdisCloseAdapterEx 返回以下状态值之一:

返回代码 描述
NDIS_STATUS_SUCCESS
NdisCloseAdapterEx 成功关闭了基础微型端口适配器的绑定。
NDIS_STATUS_PENDING
NdisCloseAdapterEx 未完成关闭作,并且作将以异步方式完成。 NDIS 调用协议驱动程序作完成后, ProtocolCloseAdapterCompleteEx 函数。

言论

协议驱动程序通常从其调用 NdisCloseAdapterEx ProtocolUnbindAdapterEx 函数。 驱动程序还可以从其 ProtocolBindAdapterEx 函数调用 NdisCloseAdapterEx。 例如,如果驱动程序在调用 NdisOpenAdapterEx后未能设置 OID 值,则可以从其 ProtocolBindAdapterEx 函数调用 NdisCloseAdapterEx

如果协议驱动程序必须在 ProtocolUnbindAdapterExProtocolBindAdapterEx上下文外关闭微型端口适配器,则必须调用 NdisUnbindAdapter 函数。

协议驱动程序应在调用 NdisCloseAdapterEx之前等待它们发起的所有发送请求和 OID 请求完成。

驱动程序调用 NdisCloseAdapterEx后,从 NdisBindingHandle 参数处的 NdisOpenAdapterEx 函数获取的句柄将变为无效。

要求

要求 价值
最低支持的客户端 NDIS 6.0 及更高版本中受支持。
目标平台 桌面
标头 ndis.h (包括 Ndis.h)
Ndis.lib
IRQL PASSIVE_LEVEL
DDI 符合性规则 Irql_Protocol_Driver_Function(ndis)

另请参阅

NdisOpenAdapterEx

NdisUnbindAdapter

ProtocolBindAdapterEx

ProtocolCloseAdapterCompleteEx

ProtocolUnbindAdapterEx