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 类型。

返回值

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

注解

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

要求

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

另请参阅

MiniportInitializeEx

NdisIMInitializeDeviceInstanceEx

NdisMRegisterMiniportDriver

UNICODE_STRING