NdisIMDeregisterLayeredMiniport (Windows Embedded CE 6.0)
1/6/2010
This function releases a previously registered intermediate driver.
Syntax
VOID NdisIMDeregisterLayeredMiniport(
NDIS_HANDLE DriverHandle
);
Parameters
- DriverHandle
[in] Specifies the handle returned by NdisIMRegisterLayeredMiniport.
Return Value
None.
Remarks
An intermediate driver that called NdisIMRegisterLayeredMiniport from its Initialization of NDIS Protocol Drivers routine must call NdisIMDeregisterLayeredMiniport when it cleans up the resources it allocated before it is unloaded. If the intermediate driver encounters a fatal initialization error within its DriverEntry routine, such as an inability to obtain system resources, it must call NdisIMDeregisterLayeredMiniport.
The NdisIMDeregisterLayeredMiniport function is the reciprocal of NdisIMRegisterLayeredMiniport. An intermediate driver typically calls NdisIMDeregisterLayeredMiniport from its ProtocolUnbindAdapter function, when the underlying NIC to which the driver was bound is being removed from the system, possibly because the NIC is being reconfigured.
The call to NdisIMDeregisterLayeredMiniport causes a call to the intermediate driver's MiniportHalt function after NDIS informs all higher-level protocols that previously bound themselves to the intermediate driver's virtual NIC that they must unbind.
Requirements
| Header | ndis.h |
| Library | ndis.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
See Also
Reference
NDIS Library Functions
MiniportHalt
ProtocolUnbindAdapter
NdisIMRegisterLayeredMiniport