NdisIMRevertBack

This function returns the function of an intermediate driver to the context in which it was executing before it called the NdisIMSwitchToMiniport function.

At a Glance

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

Syntax

VOID NdisIMRevertBack( IN NDIS_HANDLE MiniportAdapterHandle,
IN NDIS_HANDLE SwitchHandle );

Parameters

MiniportAdapterHandle: Handle input to the MiniportInitialize function.
SwitchHandle: Handle returned by the immediately preceding call to the NdisIMSwitchToMiniport function.

Remarks

An intermediate driver should call this function as quickly as possible after a driver function makes a successful call to NdisIMSwitchToMiniport.

For example, after a successful call to NdisIMSwitchToMiniport, the ProtocolXXX function of an NDIS intermediate driver can safely call NdisMXXX functions commonly called from the MiniportHandleInterrupt or the MiniportTimer functions of underlying NIC drivers. In particular, such a ProtocolXXX function can call NdisMXXX functions that indicate up to higher-level protocols bound to the intermediate driver’s virtual NIC.

Until it calls this function, the execution of such a ProtocolXXX function prevents other MiniportXXX functions in the same driver from running.

A call to this function without a SwitchHandle returned by a preceding call to NdisIMSwitchToMiniport is a fatal error.

A driver that calls this function is running at IRQL DISPATCH_LEVEL.