NdisIMRevertBack

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

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.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.0 and later Ndis.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

NdisIMSwitchToMiniport, NdisMEthIndicateReceive, NdisMIndicateReceivePacket, NdisMIndicateStatus

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.