Load_File.loadfile() - Intel Extensible Firmware Interface Specification

Extensible Firmware Interface Specification

11.1.1 LOAD_FILE.LoadFile()

Summary
Causes the driver to load a specified file.
Prototype
EFI_STATUS
(EFIAPI *EFI_LOAD_FILE) (
IN EFI_LOAD_FILE_INTERFACE *This,
IN EFI_DEVICE_PATH
IN BOOLEAN
IN OUT UINTN
IN VOID
);
Parameters
This
FilePath
BootPolicy
BufferSize
Buffer
Description
The
LoadFile()
file into Buffer, and sets
then the size of the file is returned in BufferSize. If
is not large enough to hold the entire file, then
is updated to indicate the size of the buffer needed to obtain the file. In this case, no
BufferSize
data is returned in Buffer.
210
Indicates a pointer to the calling context. Type
EFI_LOAD_FILE_INTERFACE
The device specific path of the file to load. Type
is defined in Chapter 3.
If TRUE, indicates that the request originates from the boot manager, and
that the boot manager is attempting to load
selection. If FALSE, then
loaded.
On input the size of
EFI_SUCCESS, the amount of data transferred to Buffer.
On output with a return code of EFI_BUFFER_TOO_SMALL, the size
of required to retrieve the requested file.
Buffer
The memory buffer to transfer the file to. If
the size of the requested file is returned in BufferSize.
function interprets the device-specific
to the amount of data returned. If
BufferSize
12/12/00
*FilePath,
BootPolicy,
*BufferSize,
*Buffer
is defined in Section 11.1.
FilePath
must match an exact file to be
FilePath
in bytes. On output with a return code of
Buffer
Buffer
parameter, returns the entire
FilePath
is not NULL, and
Buffer
EFI_BUFFER_TOO_SMALL
OPTIONAL
EFI_DEVICE_PATH
as a boot
is NULL, then no
is NULL,
Buffer
BufferSize
is returned, and
Version 1.02