Intel Extensible Firmware Interface, Specification

Page: 87 / 494

Services
Version 1.02 12/12/00 69
3.4.1 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
Section 3.3.1 . This field is used to initialize the
ParentHandle
field of the
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 Section 3.3.7 .
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
inSection 3.3.1.