MdePkg[all]  1.08
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Pages
LoadFile.h File Reference

Data Structures

struct  _EFI_PEI_LOAD_FILE_PPI
 

Macros

#define EFI_PEI_LOAD_FILE_PPI_GUID   { 0xb9e0abfe, 0x5979, 0x4914, { 0x97, 0x7f, 0x6d, 0xee, 0x78, 0xc2, 0x78, 0xa6 } }
 

Typedefs

typedef struct
_EFI_PEI_LOAD_FILE_PPI 
EFI_PEI_LOAD_FILE_PPI
 
typedef EFI_STATUS(EFIAPIEFI_PEI_LOAD_FILE )(IN CONST EFI_PEI_LOAD_FILE_PPI *This, IN EFI_PEI_FILE_HANDLE FileHandle, OUT EFI_PHYSICAL_ADDRESS *ImageAddress, OUT UINT64 *ImageSize, OUT EFI_PHYSICAL_ADDRESS *EntryPoint, OUT UINT32 *AuthenticationState)
 

Variables

EFI_GUID gEfiPeiLoadFilePpiGuid
 

Detailed Description

Load image file from fv to memory.

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

Revision Reference:
This PPI is introduced in PI Version 1.0.

Macro Definition Documentation

#define EFI_PEI_LOAD_FILE_PPI_GUID   { 0xb9e0abfe, 0x5979, 0x4914, { 0x97, 0x7f, 0x6d, 0xee, 0x78, 0xc2, 0x78, 0xa6 } }

Typedef Documentation

typedef EFI_STATUS(EFIAPI * EFI_PEI_LOAD_FILE)(IN CONST EFI_PEI_LOAD_FILE_PPI *This, IN EFI_PEI_FILE_HANDLE FileHandle, OUT EFI_PHYSICAL_ADDRESS *ImageAddress, OUT UINT64 *ImageSize, OUT EFI_PHYSICAL_ADDRESS *EntryPoint, OUT UINT32 *AuthenticationState)

Loads a PEIM into memory for subsequent execution.

This service is the single member function of EFI_LOAD_FILE_PPI. This service separates image loading and relocating from the PEI Foundation.

Parameters
ThisInterface pointer that implements the Load File PPI instance.
FileHandleFile handle of the file to load.
ImageAddressPointer to the address of the loaded image.
ImageSizePointer to the size of the loaded image.
EntryPointPointer to the entry point of the image.
AuthenticationStateOn exit, points to the attestation authentication state of the image or 0 if no attestation was performed.
Return values
EFI_SUCCESSThe image was loaded successfully.
EFI_OUT_OF_RESOURCESThere was not enough memory.
EFI_LOAD_ERRORThere was no supported image in the file.
EFI_INVALID_PARAMETERFileHandle was not a valid firmware file handle.
EFI_INVALID_PARAMETEREntryPoint was NULL.
EFI_UNSUPPORTEDAn image requires relocations or is not memory mapped.
EFI_WARN_BUFFER_TOO_SMALLThere is not enough heap to allocate the requested size. This will not prevent the XIP image from being invoked.

Variable Documentation

EFI_GUID gEfiPeiLoadFilePpiGuid