NdisCloseAdapter 函数 (ndis.h)

注意 NDIS 5。 x 已弃用,由 NDIS 6 取代。 x。 有关新的 NDIS 驱动程序开发,请参阅 从 Windows Vista 开始的网络驱动程序。 有关移植 NDIS 5 的信息。 NDIS 6 的 x 驱动程序。 x,请参阅 将 NDIS 5.x 驱动程序移植到 NDIS 6.0

NdisCloseAdapter 释放在协议调用 NdisOpenAdapter 时建立的绑定和分配的资源。

语法

void NdisCloseAdapter(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  NdisBindingHandle
);

参数

[out] Status

指向调用方提供的变量的指针,此函数在其中返回关闭操作的状态,可以是以下值之一:

  • NDIS_STATUS_SUCCESS
    绑定已关闭,并且已释放与该绑定相关的所有资源。

  • NDIS_STATUS_PENDING
    关闭适配器请求正在异步处理,完成关闭操作时,将调用调用者的 ProtocolCloseAdapterComplete 函数。

[in] NdisBindingHandle

指定要关闭的虚拟适配器或 NIC 的 NdisOpenAdapter 返回的句柄。

返回值

备注

返回值:无

协议驱动程序通常从其 ProtocolUnbindAdapter 函数调用 NdisCloseAdapter。 它还可以从其 ProtocolBindAdapter 函数调用 NdisCloseAdapter,例如,如果在调用 NdisOpenAdapter 以设置绑定后未能设置 OID 值。

一旦协议调用 NdisCloseAdapter,调用方应将 NdisBindingHandle 的句柄视为无效。 在对 NdisXxx 函数的任何后续调用中传递此句柄是一个编程错误。

  • 目标平台: 通用
  • 版本:Windows Vista 中的 NDIS 6.0 驱动程序不支持。 请改用 NdisCloseAdapterEx。 支持 Windows Vista 和 Windows XP 中的 NDIS 5.1 驱动程序。

要求

要求
Header ndis.h (包括 Ndis.h)
Library Ndis.lib
IRQL PASSIVE_LEVEL

另请参阅