MINIPORT_UNLOAD回调函数 (ndis.h)
NDIS 调用微型端口驱动程序的 MiniportDriverUnload 函数,以请求驱动程序在系统完成驱动程序卸载作之前释放资源。
语法
MINIPORT_UNLOAD MiniportUnload;
void MiniportUnload(
[in] PDRIVER_OBJECT DriverObject
)
{...}
参数
[in] DriverObject
指向作为驱动程序对象的 DRIVER_OBJECT 结构的指针。
返回值
没有
言论
驱动程序在调用 时指定 MiniportDriverUnload 入口点 NdisMRegisterMiniportDriver 函数。
与 NDIS 微型端口驱动程序关联的驱动程序对象指定 Unload 例程。 作系统在删除微型端口驱动程序服务的所有设备时调用 Unload 例程。 NDIS 为 NDIS 驱动程序提供 Unload 例程。 NDIS 从 Unload 例程调用微型端口驱动程序的 MiniportDriverUnload 函数。
Unload 例程的功能特定于驱动程序。 一般情况下,MiniportDriverUnload 应撤消在驱动程序 DriverEntry 例程中执行的作。
微型端口驱动程序调用从 MiniportDriverUnload NdisMDeregisterMiniportDriver 函数。
除了 NdisMDeregisterMiniportDriver,中间驱动程序还调用 NdisDeregisterProtocolDriver 函数来取消注册驱动程序的协议接口。 MiniportDriverUnload 还应执行任何必要的清理作,例如解除分配任何协议驱动程序接口资源。
如果微型端口驱动程序管理多个设备实例(例如负载均衡驱动程序),则 NDIS 不会为每个设备实例调用一次 MiniportDriverUnload,直到 NDIS 调用 MiniportHaltEx 函数。
NDIS 在 IRQL = PASSIVE_LEVEL 调用 MiniportDriverUnload。
示例
若要定义 MiniportDriverUnload 函数,必须先提供一个函数声明,用于标识要定义的函数类型。 Windows 为驱动程序提供了一组函数类型。 使用函数类型声明函数有助于 驱动程序代码分析、静态驱动程序验证程序(SDV)和其他验证工具查找错误,这是为 Windows作系统编写驱动程序的要求。例如,若要定义名为“MyDriverUnload”的 MiniportDriverUnload 函数,请使用 MINIPORT_UNLOAD 类型,如以下代码示例所示:
MINIPORT_UNLOAD MyDriverUnload;
然后,按如下所示实现函数:
_Use_decl_annotations_
VOID
MyDriverUnload(
PDRIVER_OBJECT DriverObject
)
{...}
MINIPORT_UNLOAD 函数类型在 Ndis.h 头文件中定义。 若要在运行代码分析工具时更准确地识别错误,请务必将 Use_decl_annotations 注释添加到函数定义。 Use_decl_annotations 批注可确保使用应用于头文件中 MINIPORT_UNLOAD 函数类型的批注。 有关函数声明要求的详细信息,请参阅 使用 NDIS 驱动程序的函数角色类型声明函数。
有关 Use_decl_annotations的信息,请参阅 批注函数行为。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | NDIS 6.0 及更高版本中受支持。 |
目标平台 | 窗户 |
标头 | ndis.h (包括 Ndis.h) |
IRQL | PASSIVE_LEVEL |