3.7  Halt Handler

A miniport must supply a MiniportHalt function to NdisMRegisterMiniport. The definition of MiniportHalt is:

VOID
   MiniportHalt(
       IN NDIS_HANDLE MiniportAdapterContext
       );

MiniportHalt can be called:

·If any request to set up multicast addresses, or to set MAC_OPTIONS, fails

·If all the protocol drivers bound to the miniport unbind

·During an unload operation; for instance, a NetStop command has caused an unload operation to be carried out

·During system shutdown

MiniportHalt should undo everything that MiniportInitialize did including the following:

·Free ports

·Release all the hardware resources it claimed

·Free interrupt resources by calling NdisMDeregisterInterrupt

·Free any memory it has allocated

·Terminate the wrapper

·Stop the NIC, unless the MiniportShutdown function has already restored the NIC to its initial state