NdisMResetComplete

This function returns the final status of a reset request for the NIC driver that previously returned NDIS_STATUS_PENDING.

At a Glance

Header file:	Ndis.h
Windows CE versions:	2.0 and later

Syntax

VOID NdisMResetComplete( IN NDIS_HANDLE MiniportAdapterHandle,
IN NDIS_STATUS Status, IN BOOLEAN AddressingReset );

Parameters

MiniportAdapterHandle: Handle originally input to the MiniportInitialize function.
Status: Specifies the final status of the reset operation just completed
AddressingReset: Specifies TRUE if the reset affected the miniport’s network address information so that it needs to be reloaded.

Remarks

If the MiniportReset function returns NDIS_STATUS_PENDING, the miniport must call this function when it completes the reset operation. This call causes NDIS to forward the completion-status information to the protocol driver, if any, that called NdisReset to initiate the call to MiniportReset.

The NDIS library can also call the MiniportReset function, independently of any reset requests from protocol drivers bound to a particular NIC, when NDIS determines that a sent packet or a request that it submitted to the miniport has timed out.

Some NICs lose all multicast address, packet filter, or functional address information when a soft reset is issued. The driver of such an NIC sets AddressingReset to TRUE when it calls this function, causing NDIS to call its MiniportSetInformation function to restore the addressing state.

An NDIS intermediate driver either sets AddressingReset to TRUE when it calls this function or restores its own addressing information, such as medium-specific functional, multicast, and/or group addresses.

A driver that calls this function runs at IRQL DISPATCH_LEVEL.