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.