NDIS_STATUS类型介绍

NDIS_STATUS contains the constants specifies the status of the NDIS request.

Syntax:

const NDIS_STATUS_SUCCESS              = $00000000;
const NDIS_STATUS_NOT_RECOGNIZED       = $00010001;
const NDIS_STATUS_NOT_ACCEPTED         = $00010003;
const NDIS_STATUS_FAILURE              = $C0000001;
const NDIS_STATUS_RESOURCES            = $C000009A;
const NDIS_STATUS_NOT_SUPPORTED        = $C00000BB;
const NDIS_STATUS_CLOSING              = $C0010002;
const NDIS_STATUS_RESET_IN_PROGRESS    = $C001000D;
const NDIS_STATUS_CLOSING_INDICATING   = $C001000E;
const NDIS_STATUS_INVALID_LENGTH       = $C0010014;
const NDIS_STATUS_BUFFER_TOO_SHORT     = $C0010016;
const NDIS_STATUS_INVALID_DATA         = $C0010015;
const NDIS_STATUS_INVALID_OID          = $C0010017;

#define NDIS_STATUS_SUCCESS              0x00000000
#define NDIS_STATUS_NOT_RECOGNIZED       0x00010001
#define NDIS_STATUS_NOT_ACCEPTED         0x00010003
#define NDIS_STATUS_FAILURE              0xC0000001
#define NDIS_STATUS_RESOURCES            0xC000009A
#define NDIS_STATUS_NOT_SUPPORTED        0xC00000BB
#define NDIS_STATUS_CLOSING              0xC0010002
#define NDIS_STATUS_RESET_IN_PROGRESS    0xC001000D
#define NDIS_STATUS_CLOSING_INDICATING   0xC001000E
#define NDIS_STATUS_INVALID_LENGTH       0xC0010014
#define NDIS_STATUS_BUFFER_TOO_SHORT     0xC0010016
#define NDIS_STATUS_INVALID_DATA         0xC0010015
#define NDIS_STATUS_INVALID_OID          0xC0010017

Values:

NDIS_STATUS_SUCCESS

成功。（The requested operation completed successfully.）

NDIS_STATUS_INVALID_OID

The OID_XXX code specified in the Oid member of the NDIS_REQUEST-structured buffer at NdisRequest is invalid or unsupported by the underlying driver.

NDIS_STATUS_INVALID_LENGTH or NDIS_STATUS_BUFFER_TOO_SHORT

The value specified in the InformationBufferLength member of the NDIS_REQUEST-structured buffer at NdisRequest does not match the requirements for the given OID_XXX code. If the information buffer is too small, the BytesNeeded member contains the correct value for InformationBufferLength on return from NdisRequest.

NDIS_STATUS_INVALID_DATA

The data supplied at InformationBuffer in the given NDIS_REQUEST structure is invalid for the given OID_XXX code.

NDIS_STATUS_NOT_SUPPORTED or NDIS_STATUS_NOT_RECOGNIZED

The underlying driver does not support the requested operation.

NDIS_STATUS_RESOURCES

因为缺乏资源，内存分配失败。这并不表示下次申请资源也会因为同样的原因而失败。（The request could not be satisfied due to a resource shortage. Usually, this return indicates that an attempt to allocate memory was unsuccessful, but it does not necessarily indicate that the same request, submitted later, will be failed for the same reason.）

NDIS_STATUS_NOT_ACCEPTED

The underlying driver attempted the requested operation, usually a set, on its NIC but it was failed by the netcard. For example, an attempt to set too many multicast addresses might cause the return of this value.

NDIS_STATUS_CLOSING or NDIS_STATUS_CLOSING_INDICATING

The underlying driver failed the requested operation because a close is in progress.

NDIS_STATUS_RESET_IN_PROGRESS

The underlying NIC driver cannot satisfy the request at this time because it is currently resetting the netcard.

NDIS_STATUS_FAILURE

This value usually is a nonspecific default, returned when none of the more specific NDIS_STATUS_XXX caused the underlying driver to fail the request.