NdisMDeregisterDevice 函数 (ndis.h)

  • 项目

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

NdisMDeregisterDevice 函数从系统中删除使用 NdisMRegisterDevice 创建的设备对象。 NdisMDeregisterDevice 还会删除与此设备对象关联的符号链接。

语法

NDIS_STATUS NdisMDeregisterDevice(
  [in] NDIS_HANDLE NdisDeviceHandle
);

参数

[in] NdisDeviceHandle

指定要注销的设备对象的 NdisMRegisterDevice 返回的句柄。

返回值

如果删除设备对象及其关联的符号链接对象，则 NdisMDeregisterDevice 将返回NDIS_STATUS_SUCCESS。

注解

驱动程序从其 Halt 或 Unload 函数调用 NdisMDeregisterDevice，以取消注册之前使用 NdisMRegisterDevice 创建的独立设备对象。 当驱动程序被卸载或其 DriverEntry 例程遇到致命初始化错误（例如无法获取系统资源）时，驱动程序必须调用 NdisMDeregisterDevice。

调用 NdisMRegisterDevice 时，无法对正在删除的设备对象执行任何未完成的用户模式打开操作。 如果有，则会发生系统错误。

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

要求

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

另请参阅