This function releases a set of map registers that were allocated during initialization with NdisMAllocateMapRegistersby a busmaster DMA NIC driver.

VOID NdisMFreeMapRegisters(
IN
NDIS_HANDLE
MiniportAdapterHandle
);

Parameters

MiniportAdapterHandle

Handle originally input to the MiniportInitializefunction.

Remarks

If it has already made a successful call to the NdisMAllocateMapRegistersfunction, the NIC driver of a busmaster DMA device calls this function if any of the following occurs:

• Its MiniportInitializefunction is unable to initialize the NIC, so this function must release all existing claims on hardware resources for that NIC before it returns control.
• The NIC for which the miniport allocated the map registers is being removed.
• The driver is being unloaded, either because the system is shutting down or because the user reconfigured the network components used in the machine.

  As soon as it calls this function, the driver of a busmaster DMA NIC can no longer use the map registers that it previously allocated.

  This function can be called only from an NIC driver's MiniportInitializeand MiniportHaltfunctions.

  A driver that calls this function runs at IRQL PASSIVE_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

  NdisMAllocateMapRegisters

  
  

  ---

   Last updated on Tuesday, July 13, 2004

  © 2004 Microsoft Corporation. All rights reserved.