iPXE
LoadFile2.h
Go to the documentation of this file.
1 /** @file
2  Load File protocol as defined in the UEFI 2.0 specification.
3 
4  Load file protocol exists to supports the addition of new boot devices,
5  and to support booting from devices that do not map well to file system.
6  Network boot is done via a LoadFile protocol.
7 
8  UEFI 2.0 can boot from any device that produces a LoadFile protocol.
9 
10  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>
11  This program and the accompanying materials
12  are licensed and made available under the terms and conditions of the BSD License
13  which accompanies this distribution. The full text of the license may be found at
14  http://opensource.org/licenses/bsd-license.php
15 
16  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
17  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
18 
19 **/
20 
21 #ifndef __EFI_LOAD_FILE2_PROTOCOL_H__
22 #define __EFI_LOAD_FILE2_PROTOCOL_H__
23 
24 FILE_LICENCE ( BSD3 );
25 
26 #define EFI_LOAD_FILE2_PROTOCOL_GUID \
27  { \
28  0x4006c0c1, 0xfcb3, 0x403e, {0x99, 0x6d, 0x4a, 0x6c, 0x87, 0x24, 0xe0, 0x6d } \
29  }
30 
31 ///
32 /// Protocol Guid defined by UEFI2.1.
33 ///
34 #define LOAD_FILE2_PROTOCOL EFI_LOAD_FILE2_PROTOCOL_GUID
35 
37 
38 
39 /**
40  Causes the driver to load a specified file.
41 
42  @param This Protocol instance pointer.
43  @param FilePath The device specific path of the file to load.
44  @param BootPolicy Should always be FALSE.
45  @param BufferSize On input the size of Buffer in bytes. On output with a return
46  code of EFI_SUCCESS, the amount of data transferred to
47  Buffer. On output with a return code of EFI_BUFFER_TOO_SMALL,
48  the size of Buffer required to retrieve the requested file.
49  @param Buffer The memory buffer to transfer the file to. IF Buffer is NULL,
50  then no the size of the requested file is returned in
51  BufferSize.
52 
53  @retval EFI_SUCCESS The file was loaded.
54  @retval EFI_UNSUPPORTED BootPolicy is TRUE.
55  @retval EFI_INVALID_PARAMETER FilePath is not a valid device path, or
56  BufferSize is NULL.
57  @retval EFI_NO_MEDIA No medium was present to load the file.
58  @retval EFI_DEVICE_ERROR The file was not loaded due to a device error.
59  @retval EFI_NO_RESPONSE The remote system did not respond.
60  @retval EFI_NOT_FOUND The file was not found
61  @retval EFI_ABORTED The file load process was manually canceled.
62  @retval EFI_BUFFER_TOO_SMALL The BufferSize is too small to read the current
63  directory entry. BufferSize has been updated with
64  the size needed to complete the request.
65 
66 
67 **/
68 typedef
72  IN EFI_DEVICE_PATH_PROTOCOL *FilePath,
73  IN BOOLEAN BootPolicy,
76  );
77 
78 ///
79 /// The EFI_LOAD_FILE_PROTOCOL is a simple protocol used to obtain files from arbitrary devices.
80 ///
83 };
84 
86 
87 #endif
#define OPTIONAL
Passing the datum to the function is optional, and a NULL is passed if the value is not supplied.
Definition: Base.h:340
128 bit buffer containing a unique identifier value.
Definition: Base.h:263
unsigned char BOOLEAN
Definition: ProcessorBind.h:61
EFI_GUID gEfiLoadFile2ProtocolGuid
UINT16_t BufferSize
Buffer size.
Definition: pxe_api.h:64
This protocol can be used on any device handle to obtain generic path/location information concerning...
Definition: DevicePath.h:51
EFI_LOAD_FILE2 LoadFile
Definition: LoadFile2.h:82
#define OUT
Definition: mlx_utils.h:29
#define EFIAPI
SEGOFF16_t Buffer
Buffer address.
Definition: pxe_api.h:65
UINT64 UINTN
Unsigned value of native width.
Definition: ProcessorBind.h:71
#define VOID
Undeclared type.
Definition: Base.h:319
#define IN
Definition: mlx_utils.h:28
FILE_LICENCE(BSD3)
RETURN_STATUS EFI_STATUS
Function return status for EFI API.
Definition: UefiBaseType.h:35
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.
Definition: LoadFile2.h:70
The EFI_LOAD_FILE_PROTOCOL is a simple protocol used to obtain files from arbitrary devices.
Definition: LoadFile2.h:81