NdisIMCancelInitializeDeviceInstance 函数 (ndis.h)

NdisIMCancelInitializeDeviceInstance 函数取消对上述调用 NdisIMInitializeDeviceInstanceEx 函数。

语法

NDIS_STATUS NdisIMCancelInitializeDeviceInstance(
  [in] NDIS_HANDLE  DriverHandle,
  [in] PNDIS_STRING DeviceInstance
);

参数

[in] DriverHandle

微型端口驱动程序句柄 NdisMiniportDriverHandle 参数返回的 NdisMRegisterMiniportDriver 函数。

[in] DeviceInstance

指向NDIS_STRING类型的指针,该类型描述系统默认字符集中调用方初始化的计数字符串。 该字符串包含注册表项的名称,驱动程序在其中存储有关虚拟微型端口的信息,以及可能特定于绑定的信息。 对于 Microsoft Windows 2000 及更高版本的驱动程序,此字符串包含 Unicode 字符。 也就是说,对于 Windows 2000 及更高版本,NDIS 将NDIS_STRING类型定义为 UNICODE_STRING 类型。

返回值

NdisIMCancelInitializeDeviceInstance 如果取消了对 NdisIMInitializeDeviceInstanceEx的上述调用,则返回NDIS_STATUS_SUCCESS。 否则,如果无法停止虚拟微型端口的初始化作,它将返回NDIS_STATUS_FAILURE。

言论

中间驱动程序调用 NdisIMInitializeDeviceInstanceEx 函数来启动虚拟微型端口的初始化作。在 NDIS 调用驱动程序的 MiniportInitializeEx 函数之前,驱动程序可以调用 NdisIMCancelInitializeDeviceInstance 取消初始化作。 例如,如果删除中间驱动程序需要执行正常作的基础驱动程序,则中间驱动程序可以取消与已删除驱动程序关联的任何虚拟微型端口的初始化。

要求

要求 价值
最低支持的客户端 Windows Vista 中支持 NDIS 6.0 和 NDIS 5.1 驱动程序(请参阅 NdisIMCancelInitializeDeviceInstance (NDIS 5.1) 。 支持 NDIS 5.1 驱动程序(请参阅 Windows XP 中的 NdisIMCancelInitializeDeviceInstance (NDIS 5.1) 。
目标平台 桌面
标头 ndis.h (包括 Ndis.h)
Ndis.lib
IRQL PASSIVE_LEVEL
DDI 符合性规则 Irql_IM_Function(ndis)

另请参阅

MiniportInitializeEx

NdisIMInitializeDeviceInstanceEx

NdisMRegisterMiniportDriver

UNICODE_STRING