Microsoft Windows CE 3.0  

NdisIMRevertBack

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

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

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

Parameters

MiniportAdapterHandle
Handle input to the MiniportInitializefunction.
SwitchHandle
Handle returned by the immediately preceding call to the NdisIMSwitchToMiniportfunction.

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 Protocol XXXfunction of an NDIS intermediate driver can safely call NdisM XXXfunctions commonly called from the MiniportHandleInterruptor the MiniportTimerfunctions of underlying NIC drivers. In particular, such a Protocol XXXfunction can call NdisM XXXfunctions 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 Protocol XXXfunction prevents other Miniport XXXfunctions in the same driver from running.

A call to this function without a SwitchHandlereturned by a preceding call to NdisIMSwitchToMiniportis 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

© 2004 Microsoft Corporation. All rights reserved.