NdisMResetComplete - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// ndis.h
void NdisMResetComplete(
_M,
_S,
_A
);
View the official Windows Driver Kit DDI reference// ndis.h
VOID NdisMResetComplete(
NDIS_HANDLE MiniportAdapterHandle,
NDIS_STATUS Status,
BOOLEAN AddressingReset
);
View the official Windows Driver Kit DDI referenceNo description available.
[!NOTE] For NDIS 6.x (Windows Vista and later), use the NdisMResetComplete function (NDIS 6.x) instead.
The NdisMResetComplete function returns the final status of a reset request for which the miniport driver previously returned NDIS_STATUS_PENDING.
_MThe miniport adapter handle that NDIS originally passed to the MiniportInitializeEx function.
_SThe final status of the reset operation just completed. The return values are the same as those listed for the MINIPORT_RESET callback function.
_AA Boolean value that is TRUE if NDIS is responsible for restoring the settings for multicast addresses, packet filters, and task offload information. In this case, the miniport driver is responsible for restoring the rest of the configuration settings for the network interface card (NIC) referenced by MiniportAdapterHandle .
If AddressingReset is FALSE, the miniport driver is responsible for restoring all of the configuration settings for the NIC.
For more information, see Hardware Reset.
If the MiniportResetEx function returns NDIS_STATUS_PENDING, the miniport driver must call NdisMResetComplete when it completes the reset operation.
Protocol drivers cannot initiate a reset operation in NDIS 6.0 and later versions.
Some NICs lose all multicast address, packet filter, or functional address information when a soft reset is issued. The driver of such a NIC sets AddressingReset to TRUE when it calls NdisMResetComplete, causing NDIS to call its MiniportOidRequest function to restore the addressing state. For more information, see Hardware Reset.
A miniport driver must release any spin lock that it is holding before calling NdisMResetComplete.
In NDIS 6.0 and later, callers of NdisMResetComplete must run at IRQL <= DISPATCH_LEVEL. Otherwise, callers of NdisMResetComplete must run at IRQL = DISPATCH_LEVEL.
NdisMResetComplete function (NDIS 6.x)
The NdisMResetComplete function returns the final status of a reset request for which the miniport driver previously returned NDIS_STATUS_PENDING.
MiniportAdapterHandleThe miniport adapter handle that NDIS originally passed to the MiniportInitializeEx function.
StatusThe final status of the reset operation just completed. The return values are the same as those listed for the MINIPORT_RESET callback function.
AddressingResetA Boolean value that is TRUE if NDIS is responsible for restoring the settings for multicast addresses, packet filters, and task offload information. In this case, the miniport driver is responsible for restoring the rest of the configuration settings for the network interface card (NIC) referenced by MiniportAdapterHandle .
If AddressingReset is FALSE, the miniport driver is responsible for restoring all of the configuration settings for the NIC.
For more information, see Hardware Reset.
If the MiniportResetEx function returns NDIS_STATUS_PENDING, the miniport driver must call NdisMResetComplete when it completes the reset operation.
Protocol drivers cannot initiate a reset operation in NDIS 6.0 and later versions.
Some NICs lose all multicast address, packet filter, or functional address information when a soft reset is issued. The driver of such a NIC sets AddressingReset to TRUE when it calls NdisMResetComplete, causing NDIS to call its MiniportOidRequest function to restore the addressing state. For more information, see Hardware Reset.
A miniport driver must release any spin lock that it is holding before calling NdisMResetComplete.
In NDIS 6.0 and later, callers of NdisMResetComplete must run at IRQL <= DISPATCH_LEVEL. Otherwise, callers of NdisMResetComplete must run at IRQL = DISPATCH_LEVEL.
NdisMResetComplete macro (NDIS 5.x)