Развернуть Свернуть

NdisMRegisterAdapterShutdownHandler function

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.

Syntax


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

Parameters

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.

Return value

None

Remarks

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.

Requirements

Version

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.

Header

Ndis.h (include Ndis.h)

IRQL

PASSIVE_LEVEL

See also

MiniportInitialize
MiniportShutdown
NdisMDeregisterAdapterShutdownHandler
NdisMRegisterMiniport
NdisIMRegisterLayeredMiniport

 

 

Send comments about this topic to Microsoft

Показ:
© 2014 Microsoft