PE_COFF_LOADER_IMAGE_CONTEXT Struct Reference


Data Fields

PHYSICAL_ADDRESS ImageAddress
UINT64 ImageSize
PHYSICAL_ADDRESS DestinationAddress
PHYSICAL_ADDRESS EntryPoint
PE_COFF_LOADER_READ_FILE ImageRead
VOID * Handle
VOID * FixupData
UINT32 SectionAlignment
UINT32 PeCoffHeaderOffset
UINT32 DebugDirectoryEntryRva
VOID * CodeView
CHAR8PdbPointer
UINTN SizeOfHeaders
UINT32 ImageCodeMemoryType
UINT32 ImageDataMemoryType
UINT32 ImageError
UINTN FixupDataSize
UINT16 Machine
UINT16 ImageType
BOOLEAN RelocationsStripped
BOOLEAN IsTeImage
PHYSICAL_ADDRESS HiiResourceData
UINT64 Context

Detailed Description

The context structure used while PE/COFF image is being loaded and relocated.

Field Documentation

Set by PeCoffLoaderLoadImage() to CodeView area of the PE/COFF Debug directory.

Private storage for implementation specific data.

Set by PeCoffLoaderGetImageInfo() to the Relative Virtual Address of the debug directory, if it exists in the image

Is set to zero by PeCoffLoaderGetImageInfo(). If DestinationAddress is non-zero, PeCoffLoaderRelocateImage() will relocate the image using this base address. If the DestinationAddress is zero, the ImageAddress will be used as the base address of relocation.

PeCoffLoaderLoadImage() sets EntryPoint to to the entry point of the PE/COFF image.

Caller allocated buffer of size FixupDataSize that can be optionally allocated prior to calling PeCoffLoaderRelocateImage(). This buffer is filled with the information used to fix up the image. The fixups have been applied to the image and this entry is just for information.

Set by PeCoffLoaderLoadImage() to indicate the size of FixupData that the caller must allocate before calling PeCoffLoaderRelocateImage().

Used as the FileHandle passed into the ImageRead function when it's called.

Set by PeCoffLoaderLoadImage() to the HII resource offset if the image contains a custom PE/COFF resource with the type 'HII'. Otherwise, the entry remains to be 0.

Set by PeCoffLoaderGetImageInfo() to the ImageBase in the PE/COFF header.

Referenced by PeCoffLoaderLoadImage().

Not used by this library class. Other library classes that layer on top of this library class fill in this value as part of their GetImageInfo call. This allows the caller of the library to know what type of memory needs to be allocated to load and relocate the image.

Not used by this library class. Other library classes that layer on top of this library class fill in this value as part of their GetImageInfo call. This allows the caller of the library to know what type of memory needs to be allocated to load and relocate the image.

Set by any of the library functions if they encounter an error.

Passed in by the caller to PeCoffLoaderGetImageInfo() and PeCoffLoaderLoadImage() to abstract accessing the image from the library.

Set by PeCoffLoaderGetImageInfo() to the SizeOfImage in the PE/COFF header. Image size includes the size of Debug Entry if it is present.

Referenced by PeCoffLoaderLoadImage().

Set by PeCoffLoaderGetImageInfo() to the subsystem type stored in the PE/COFF header.

Referenced by PeCoffLoaderLoadImage().

Set by PeCoffLoaderGetImageInfo() to TRUE if the image is a TE image. For a definition of the TE Image format, see the Platform Initialization Pre-EFI Initialization Core Interface Specification.

Set by PeCoffLoaderGetImageInfo() to the machine type stored in the PE/COFF header.

Set by PeCoffLoaderLoadImage() to point to the PDB entry contained in the CodeView area. The PdbPointer points to the filename of the PDB file used for source-level debug of the image by a debugger.

Set by PeCoffLoaderGetImageInfo() to offset to the PE/COFF header. If the PE/COFF image does not start with a DOS header, this value is zero. Otherwise, it's the offset to the PE/COFF header.

Set by PeCoffLoaderGetImageInfo() to TRUE if the PE/COFF image does not contain relocation information.

Referenced by PeCoffLoaderLoadImage().

Set by PeCoffLoaderGetImageInfo() to the Section Alignment in the PE/COFF header. If the image is a TE image, then this field is set to 0.

Referenced by PeCoffLoaderLoadImage().

Is set by PeCoffLoaderGetImageInfo() to the Section Alignment in the PE/COFF header.


Generated on Thu Sep 24 23:14:28 2015 for MdePkg[ALL] by  doxygen 1.5.7.1