Share via

NdisIMCancelInitializeDeviceInstance (Compact 2013)

  • Article

3/26/2014

This function cancels a previous call to the NdisIMInitializeDeviceInstanceEx function.

Syntax

NDIS_STATUS NdisIMCancelInitializeDeviceInstance(
  NDIS_HANDLE DriverHandle,
  PNDIS_STRING DeviceInstance
);

Parameters

  • DriverHandle
    [in] The miniport driver handle that the NdisMRegisterMiniportDriver function returned at the NdisMiniportDriverHandle parameter.
  • DeviceInstance
    [in] A pointer to an NDIS_STRING type that describes a caller-initialized counted string in the system-default character set. The string contains the name of the registry key in which the driver stores information about a virtual miniport and, possibly, binding-specific information.

Return Value

The following table shows the return values for NdisIMCancelInitializeDeviceInstance.

Value

Description

NDIS_STATUS_SUCCESS

Returned if the previous call was canceled.

NDIS_STATUS_FAILURE

Returned if the function was unable to stop the intermediate driver from initializing its virtual network adapter.

Remarks

An intermediate driver calls the NdisIMInitializeDeviceInstanceEx function to initiate the initialization operation for a virtual miniports.Before NDIS calls the driver's MiniportInitializeEx function, the driver can call NdisIMCancelInitializeDeviceInstance to cancel the initialization operation. For example, if an underlying driver that the intermediate driver requires for typical operation is removed, the intermediate driver can cancel the initialization for any virtual miniports that are associated with the removed driver.

Requirements

Header

ndis.h

Library

ndis.lib

See Also

Reference

NDIS Functions for Intermediate Drivers
MiniportInitializeEx
NdisIMInitializeDeviceInstance
NdisIMRegisterLayeredMiniport
NdisIMInitializeDeviceInstanceEx
NdisMRegisterMiniportDriver