beautypg.com

Loadimage(), Which – Intel Extensible Firmware Interface User Manual

Page 176

background image

Extensible Firmware Interface Specification

5-78

12/01/02

Version 1.10

LoadImage()

Summary

Loads an EFI image into memory.

Prototype

EFI_STATUS
LoadImage (

IN BOOLEAN

BootPolicy,

IN EFI_HANDLE

ParentImageHandle,

IN EFI_DEVICE_PATH

*FilePath,

IN VOID

*SourceBuffer OPTIONAL,

IN UINTN

SourceSize,

OUT EFI_HANDLE

*ImageHandle

);

Parameters

BootPolicy

If

TRUE

, indicates that the request originates from the boot

manager, and that the boot manager is attempting to load

FilePath

as a boot selection. Ignored if

SourceBuffer

is

not

NULL

.

ParentImageHandle

The caller’s image handle. Type

EFI_HANDLE

is defined in the

InstallProtocolInterface()

function description.

This field is used to initialize the

ParentHandle

field of the

EFI_LOADED_IMAGE

protocol for the image that is being

loaded.

FilePath

The

DeviceHandle

specific file path from which the image is

loaded. Type

EFI_DEVICE_PATH

is defined in the

LocateDevicePath()

function description.

SourceBuffer

If not

NULL

, a pointer to the memory location containing a copy

of the image to be loaded.

SourceSize

The size in bytes of

SourceBuffer

. Ignored if

SourceBuffer

is

NULL

.

ImageHandle

Pointer to the returned image handle that is created when the
image is successfully loaded. Type

EFI_HANDLE

is defined in

the

InstallProtocolInterface()

function description.