NdisMRegisterAdapterShutdownHandler

NdisMRegisterAdapterShutdownHandler registers a NIC-driver-supplied MiniportShutdown function to be called when the system is shutting down.

VOID
  NdisMRegisterAdapterShutdownHandler(
    IN NDIS_HANDLE  MiniportHandle,
    IN PVOID  ShutdownContext,
    IN ADAPTER_SHUTDOWN_HANDLER  ShutdownHandler
    );

Parameters

MiniportHandle

Specifies the handle input to MiniportInitialize.

ShutdownContext

Pointer to a driver-determined context area. This pointer will be passed to the function at ShutdownHandler when it is called.

ShutdownHandler

Specifies the entry point of the caller’s MiniportShutdown function.

Headers

Declared in Ndis.h. Include Ndis.h.

Comments

NDIS 5.0 miniport drivers and intermediate drivers can optionally register a MiniportShutdown function by calling NdisMRegisterAdapterShutdownHandler. NDIS 5.1 miniport drivers and intermediate drivers must register a MiniportShutdown function by calling NdisMRegisterMiniport or NdisIMRegisterLayeredMiniport, respectively.

Whenever an NDIS 5.0 miniport driver's or intermediate driver’s MiniportInitialize function successfully initializes a NIC, it calls NdisMRegisterAdapterShutdownHandler, usually just before MiniportInitialize returns NDIS_STATUS_SUCCESS.

Every NDIS 5.0 NIC driver should register a MiniportShutdown function when it initializes. MiniportShutdown is responsible for restoring the NIC to its initial state before the system is shut down.

Callers of NdisMRegisterAdapterShutdownHandler run at IRQL = PASSIVE_LEVEL.

See Also

MiniportInitialize, MiniportShutdown, NdisMDeregisterAdapterShutdownHandler, NdisMRegisterMiniport, NdisIMRegisterLayeredMiniport