NdisMRemoveMiniport function (ndis.h)

The NdisMRemoveMiniport function removes the specified miniport driver adapter that the miniport driver has determined is unrecoverable from the system.

Syntax

NDIS_STATUS NdisMRemoveMiniport(
  NDIS_HANDLE MiniportHandle
);

Parameters

MiniportHandle

The handle to the initialized miniport adapter that the miniport driver has determined is unrecoverable.

Return value

NdisMRemoveMiniport can return either of the following:

Return code Description
NDIS_STATUS_SUCCESS
The miniport adapter has been removed.
NDIS_STATUS_FAILURE
An attempt to remove the miniport adapter failed.

Remarks

If a miniport driver has determined that a particular miniport adapter has failed and is unrecoverable, the miniport driver can call NdisMRemoveMiniport to remove the miniport adapter from the local computer system. In this call, the miniport driver passes the handle to the miniport adapter to remove.

For example, if a miniport driver detects that a miniport adapter is resetting very frequently and is causing the computer to freeze every few seconds, the driver can request NDIS to remove the miniport adapter.

Requirements

Requirement Value
Minimum supported client Supported in NDIS 5.1, and NDIS 6.0 and later. For NDIS 5.1 drivers, see NdisMRemoveMiniport (NDIS 5.1).
Target Platform Universal
Header ndis.h (include Ndis.h)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI compliance rules Irql_Miniport_Driver_Function(ndis)