Compartir a través de


NdisIMCancelInitializeDeviceInstance (NDIS 5.1) function

Note   NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.

The NdisIMCancelInitializeDeviceInstance function cancels a preceding call to NdisIMInitializeDeviceInstance.

Syntax

NDIS_STATUS NdisIMCancelInitializeDeviceInstance(
  _In_ NDIS_HANDLE  DriverHandle,
  _In_ PNDIS_STRING DeviceInstance
);

Parameters

  • DriverHandle [in]
    Specifies the handle returned by NdisIMRegisterLayeredMiniport.

  • DeviceInstance [in]
    Pointer to an NDIS_STRING type that describes a caller-initialized counted string, in the system-default character set, naming the registry key in which the driver stores information about its virtual NIC and, possibly, binding-specific information. For Windows 2000 and later drivers, this string contains Unicode characters. That is, for Windows 2000 and later, NDIS defines the NDIS_STRING type as a UNICODE_STRING type.

Return value

NdisIMCancelInitializeDeviceInstance returns NDIS_STATUS_SUCCESS if it canceled the preceding call to NdisIMInitializeDeviceInstance. Otherwise, it returns NDIS_STATUS_FAILURE if there is no way to stop the initialization operation for the virtual NIC.

Remarks

An intermediate driver calls the NdisIMInitializeDeviceInstance or NdisIMInitializeDeviceInstanceEx function to initiate the initialization operation for its virtual NICs.Before NDIS calls the driver's MiniportInitialize function, the driver can call NdisIMCancelInitializeDeviceInstance to cancel the initialization operation. For example, if an underlying driver that the intermediate driver requires for normal operation is removed, the intermediate driver can cancel the initialization for any virtual NICs that are associated with the removed driver.

Requirements

Target platform

Universal

Version

See NdisIMCancelInitializeDeviceInstance.

Header

Ndis.h (include Ndis.h)

Library

Ndis.lib

IRQL

PASSIVE_LEVEL

See also

ANSI_STRING

MiniportInitialize

NdisIMInitializeDeviceInstance

NdisIMInitializeDeviceInstanceEx

NdisIMRegisterLayeredMiniport

UNICODE_STRING

 

 

Send comments about this topic to Microsoft