beautypg.com

Appendix d status codes – Intel Extensible Firmware Interface User Manual

Page 865

background image

Version 1.10

12/01/02

D-1

Appendix D

Status Codes

EFI interfaces return an

EFI_STATUS

code. Table D-2, Table D-3, and Table D-4 list these codes

for success, errors, and warnings, respectively. Error codes also have their highest bit set, so all
error codes have negative values. The range of status codes that have the highest bit set and the
next to highest bit clear are reserved for use by EFI. The range of status codes that have both the
highest bit set and the next to highest bit set are reserved for use by OEMs. Success and warning
codes have their highest bit clear, so all success and warning codes have positive values. The range
of status codes that have both the highest bit clear and the next to highest bit clear are reserved for
use by EFI. The range of status code that have the highest bit clear and the next to highest bit set
are reserved for use by OEMs. Table D-1 lists the status code ranges described above.

Table D-1. EFI_STATUS Codes Ranges


IA-32 Range

Itanium Architecture
Range


Description

0x00000000-

0x3fffffff

0x0000000000000000-

0x3fffffffffffffff

Success and warning codes reserved for use by EFI. See
Table D-2 and Table D-4 for valid values in this range.

0x40000000-

0x7fffffff

0x4000000000000000-

0x7fffffffffffffff

Success and warning codes reserved for use by OEMs.

0x80000000-

0xbfffffff

0x8000000000000000-

0xbfffffffffffffff

Error codes reserved for use by EFI. See Table D-3 for
valid values for this range.

0xc0000000-

0xffffffff

0xc000000000000000-

0xffffffffffffffff

Error codes reserved for use by OEMs.

Table D-2. EFI_STATUS Success Codes (High Bit Clear)

Mnemonic

Value

Description

EFI_SUCCESS

0

The operation completed successfully.

Table D-3. EFI_STATUS Error Codes (High Bit Set)

Mnemonic

Value

Description

EFI_LOAD_ERROR

1

The image failed to load.

EFI_INVALID_PARAMETER

2

A parameter was incorrect.

EFI_UNSUPPORTED

3

The operation is not supported.

EFI_BAD_BUFFER_SIZE

4

The buffer was not the proper size for the request.

EFI_BUFFER_TOO_SMALL

5

The buffer is not large enough to hold the requested data.
The required buffer size is returned in the appropriate
parameter when this error occurs.

continued