NdisReset (Windows CE 5.0)

Send Feedback

This function forwards a reset request to an underlying driver.

VOID NdisReset(PNDIS_STATUS Status,NDIS_HANDLE NdisBindingHandle);

Parameters

  • Status
    [out] Pointer to a caller-supplied variable that is set on return from this function. The underlying driver determines which NDIS_STATUS_XXX is returned.
  • NdisBindingHandle
    [in] Handle returned by the NdisOpenAdapter function that identifies the target NIC or the virtual adapter of the next-lower driver to which the caller is bound.

Return Values

The following table shows typical return values for this function.

Value Description
NDIS_STATUS_SUCCESS The underlying driver reset its NIC or virtual NIC to its initial state.
NDIS_STATUS_PENDING The request is being handled asynchronously, and the caller's ProtocolResetComplete function will be called when it is completed.
NDIS_STATUS_RESET_IN_PROGRESS The underlying driver is currently resetting its NIC, so this request is superfluous. Moreover, the caller's ProtocolStatus function was or will be called with NDIS_STATUS_RESET_START to indicate that a reset is in progress.
NDIS_STATUS_NOT_RESETTABLE The underlying NIC cannot be reset by software commands.
NDIS_STATUS_ADAPTER_REMOVED or NDIS_STATUS_FAILURE The caller's binding is already closed, so no reset will be attempted for this caller.
NDIS_STATUS_CLOSING The caller's binding is currently being closed, so no reset will be attempted for this caller.
NDIS_STATUS_SOFT_ERRORS The underlying NIC driver reset the netcard, but one or more recoverable hardware errors occurred during this operation. The NIC driver has logged the errors.
NDIS_STATUS_HARD_ERRORS The underlying NIC driver attempted to reset the netcard, but one or more unrecoverable hardware errors occurred during this operation. The NIC driver has logged the errors.
NDIS_STATUS_NOT_ACCEPTED This value usually is a nonspecific default, returned when none of the more specific NDIS_STATUS_XXX caused NDIS or the underlying NIC driver to fail the request.

Remarks

None.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Ndis.h.

See Also

ProtocolStatus | ProtocolResetComplete | NdisOpenAdapter

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.