NdisReset (Windows CE 5.0)
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