Load File protocol as defined in the UEFI 2.0 specification. More...

Data Structures
struct	_EFI_LOAD_FILE2_PROTOCOL
	The EFI_LOAD_FILE_PROTOCOL is a simple protocol used to obtain files from arbitrary devices. More...

Macros
#define	EFI_LOAD_FILE2_PROTOCOL_GUID

#define	LOAD_FILE2_PROTOCOL EFI_LOAD_FILE2_PROTOCOL_GUID
	Protocol Guid defined by UEFI2.1. More...

Typedefs
typedef struct _EFI_LOAD_FILE2_PROTOCOL	EFI_LOAD_FILE2_PROTOCOL

typedef EFI_STATUS(EFIAPI *	EFI_LOAD_FILE2) (IN EFI_LOAD_FILE2_PROTOCOL This, IN EFI_DEVICE_PATH_PROTOCOL FilePath, IN BOOLEAN BootPolicy, IN OUT UINTN BufferSize, IN VOID Buffer OPTIONAL)
	Causes the driver to load a specified file. More...

Functions
	FILE_LICENCE (BSD2_PATENT)

Variables
EFI_GUID	gEfiLoadFile2ProtocolGuid

Detailed Description

Load File protocol as defined in the UEFI 2.0 specification.

Load file protocol exists to supports the addition of new boot devices, and to support booting from devices that do not map well to file system. Network boot is done via a LoadFile protocol.

UEFI 2.0 can boot from any device that produces a LoadFile protocol.

Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent

Definition in file LoadFile2.h.

Macro Definition Documentation

◆ EFI_LOAD_FILE2_PROTOCOL_GUID

#define EFI_LOAD_FILE2_PROTOCOL_GUID

Value:

{ \
    0x4006c0c1, 0xfcb3, 0x403e, {0x99, 0x6d, 0x4a, 0x6c, 0x87, 0x24, 0xe0, 0x6d } \
  }

Definition at line 20 of file LoadFile2.h.

◆ LOAD_FILE2_PROTOCOL

#define LOAD_FILE2_PROTOCOL EFI_LOAD_FILE2_PROTOCOL_GUID

Protocol Guid defined by UEFI2.1.

Definition at line 28 of file LoadFile2.h.

Typedef Documentation

◆ EFI_LOAD_FILE2_PROTOCOL

typedef struct _EFI_LOAD_FILE2_PROTOCOL EFI_LOAD_FILE2_PROTOCOL

Definition at line 30 of file LoadFile2.h.

◆ EFI_LOAD_FILE2

typedef EFI_STATUS(EFIAPI * EFI_LOAD_FILE2) (IN EFI_LOAD_FILE2_PROTOCOL *This, IN EFI_DEVICE_PATH_PROTOCOL *FilePath, IN BOOLEAN BootPolicy, IN OUT UINTN *BufferSize, IN VOID *Buffer OPTIONAL)

Causes the driver to load a specified file.

Parameters

This	Protocol instance pointer.
FilePath	The device specific path of the file to load.
BootPolicy	Should always be FALSE.
BufferSize	On input the size of Buffer in bytes. On output with a return code of EFI_SUCCESS, the amount of data transferred to Buffer. On output with a return code of EFI_BUFFER_TOO_SMALL, the size of Buffer required to retrieve the requested file.
Buffer	The memory buffer to transfer the file to. IF Buffer is NULL, then no the size of the requested file is returned in BufferSize.

Return values

EFI_SUCCESS	The file was loaded.
EFI_UNSUPPORTED	BootPolicy is TRUE.
EFI_INVALID_PARAMETER	FilePath is not a valid device path, or BufferSize is NULL.
EFI_NO_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 canceled.
EFI_BUFFER_TOO_SMALL	The BufferSize is too small to read the current directory entry. BufferSize has been updated with the size needed to complete the request.

Definition at line 63 of file LoadFile2.h.

Function Documentation

◆ FILE_LICENCE()

FILE_LICENCE ( BSD2_PATENT )

Variable Documentation

◆ gEfiLoadFile2ProtocolGuid

EFI_GUID gEfiLoadFile2ProtocolGuid

Data Structures

Macros

Typedefs

Functions

Variables