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 ThesizeinbytesofSourceBuffer. 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.