Status codes returned – Intel Extensible Firmware Interface User Manual

Page 363

Advertising
background image

Protocols

— Bootable Image Support

Version 1.10

12/01/02

11-3

If

BootPolicy

is

TRUE

the firmware’s boot manager is attempting to load an EFI image that is a

boot selection. In this case,

FilePath

contains the file path value in the boot selection option.

Normally the firmware would implement the policy on how to handle an inexact boot file path;
however, since in this case the firmware cannot interpret the file path, the

LoadFile()

function

is responsible for implementing the policy. For example, in the case of a network boot through the
PXE Base Code protocol,

FilePath

merely points to the root of the device, and the firmware

interprets this as wanting to boot from the first valid loader. The following is list of events that

LoadFile()

will implement for a PXE boot:

• Perform DHCP.
• Optionally prompt the user with a menu of boot selections.
• Discover the boot server and the boot file.
• Download the boot file into

Buffer

and update

BufferSize

with the size of the boot file.

Status Codes Returned

EFI_SUCCESS

The file was loaded.

EFI_UNSUPPORTED

The device does not support the provided

BootPolicy

.

EFI_INVALID_PARAMETER

FilePath

is not a valid device path, or

BufferSize

is

NULL

.

EFI_NO_SUCH_MEDIA

No medium was present to load the file.

EFI_DEVICE_ERROR

The file was not loaded due to a device error.

EFI_NO_RESPONSE

The remote system did not respond.

EFI_NOT_FOUND

The file was not found.

EFI_ABORTED

The file load process was manually cancelled.

Advertising