NdisMRestartComplete function

A miniport driver must call the NdisMRestartComplete function to complete a restart operation if the driver returned NDIS_STATUS_PENDING from its MiniportRestart function.

Syntax


VOID NdisMRestartComplete(
  _In_  NDIS_HANDLE MiniportAdapterHandle,
  _In_  NDIS_STATUS Status
);

Parameters

MiniportAdapterHandle [in]

The miniport adapter handle that NDIS passed to the MiniportAdapterHandle parameter of the MiniportInitializeEx function.

Status [in]

The final status of the restart operation. The following status values are supported:

NDIS_STATUS_SUCCESS

The driver successfully restarted the flow of network data through the miniport adapter.

NDIS_STATUS_RESOURCES

The restart failed because of insufficient resources.

NDIS_STATUS_FAILURE

The driver indicates NDIS_STATUS_FAILURE if none of the preceding values applies. The driver should call the NdisWriteErrorLogEntry function with parameters that specify the reason for the failure.

Return value

None

Remarks

The miniport adapter specified at MiniportAdapterHandle enters the Restarting state when NDIS calls the MiniportRestart function.

After the miniport driver successfully restarts the send and receive operations for the miniport adapter, the driver must complete the pending restart operation. The pending restart operation is complete after the driver calls NdisMRestartComplete. The miniport adapter is in the Running state after the restart operation is complete.

A miniport driver can resume indicating received packets immediately after NDIS calls MiniportRestart and before the driver calls NdisMRestartComplete. The driver should be ready to accept send requests after it completes the restart request.

Requirements

Version

Supported in NDIS 6.0 and later.

Header

Ndis.h (include Ndis.h)

IRQL

<= DISPATCH_LEVEL

DDI compliance rules

Irql_Miniport_Driver_Function

See also

MiniportInitializeEx
MiniportRestart
NdisWriteErrorLogEntry

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft