Convertpointer() - Intel Extensible Firmware Interface Specification

Extensible Firmware Interface Specification
3.7.2

ConvertPointer()

Summary
Determines the new virtual address that is to be used on subsequent memory accesses.
Prototype
EFI_STATUS
ConvertPointer (
IN UINTN
IN VOID
);
Parameters
DebugDisposition
Address
Related Definitions
//*******************************************************
// EFI_OPTIONAL_PTR
//*******************************************************
#define EFI_OPTIONAL_PTR
Description
The
ConvertPointer()
SetVirtualAddressMap()
The
ConvertPointer()
proper value for the new address map. Only runtime components need to perform this operation.
The
CreateEvent()
map is changing. All pointers the component has allocated or assigned must be updated.
If the
EFI_OPTIONAL_PTR
Once all components have been notified of the address map change, firmware fixes any compiled in
pointers that are embedded in any runtime image.
Status Codes Returned
EFI_SUCCESS
EFI_NOT_FOUND
EFI_INVALID_PARAMETER
94
DebugDisposition,
**Address
Supplies type information for the pointer being converted. See
"Related Definitions".
A pointer to a pointer that is to be fixed to be the value needed
for the new virtual address mappings being applied.
function is used by an EFI component during the
operation.
function updates the current pointer pointed to by
function is used to create an event that is to be notified when the address
flag is specified, the pointer being converted is allowed to be NULL.
The pointer pointed to by
The pointer pointed to by
of the current memory map. This is normally fatal.
One of the parameters has an invalid value.
12/12/00
0x00000001
Address
Address
was modified.
Address
was not found to be part
Version 1.02
to be the