NdisMRegisterUnloadHandler 函数 (ndis.h)

  • 项目

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

NdisMRegisterUnloadHandler 函数为驱动程序注册卸载处理程序。

语法

void NdisMRegisterUnloadHandler(
  [in] NDIS_HANDLE    NdisWrapperHandle,
  [in] PDRIVER_UNLOAD UnloadHandler
);

参数

[in] NdisWrapperHandle

指定 NdisMInitializeWrapper 返回的句柄。

[in] UnloadHandler

指定驱动程序的卸载例程的入口点。 卸载例程的声明如下：

VOID
(*PDRIVER_UNLOAD) (
    IN struct _DRIVER_OBJECT *DriverObject
    );

返回值

无

备注

驱动程序在 DriverEntry 调用 NdisMRegisterMiniport 或 NdisIMRegisterLayeredMiniport 后，从其 DriverEntry 函数调用 NdisMRegisterUnloadHandler。 NdisMRegisterUnloadHandler 为驱动程序注册卸载处理程序。

卸载处理程序的功能特定于驱动程序。 例如，中间驱动程序应注册一个卸载处理程序，该处理程序调用 NdisDeregisterProtocol 来取消注册中间驱动程序的协议部分。 卸载处理程序还应执行任何必要的清理操作，例如解除分配驱动程序的协议部分使用的资源。

监视多个微型端口驱动程序实例的微型端口驱动程序（例如负载均衡微型端口驱动程序）应注册一个卸载处理程序，该处理程序在它监视的微型端口驱动程序实例停止后清理状态信息并解除分配资源。 请注意，卸载处理程序不同于 MiniportHalt 函数：卸载处理程序具有更全局的范围，而 MiniportHalt 函数的范围仅限于特定的微型端口驱动程序实例。

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

要求

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

另请参阅