Note NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.
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 );
- MiniportHandle [in]
Specifies the handle input to MiniportInitialize.
- ShutdownContext [in]
Pointer to a driver-determined context area. This pointer will be passed to the function at ShutdownHandler when it is called.
- ShutdownHandler [in]
Specifies the entry point of the caller's MiniportShutdown function.
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.
|Not supported for NDIS 6.0 drivers in Windows Vista. Use NdisMRegisterMiniportDriverinstead. Supported for NDIS 5.1 drivers in Windows Vista and Windows XP. Use NdisMRegisterMiniportinstead.|