Intel Extensible Firmware Interface, Specification

Page: 67 / 494

Services
Version 1.02 12/12/00 49
3.2.3 GetMemoryMap()
Summary
Returns the current memory map.
Prototype
EFI_STATUS
GetMemoryMap (
IN OUT UINTN *MemoryMapSize,
IN OUT EFI_MEMORY_DESCRIPTOR *MemoryMap,
OUT UINTN *MapKey,
OUT UINTN *DescriptorSize,
OUT UINT32 *DescriptorVersion
);
Parameters
MemoryMapSize
A pointer to the size, in bytes, of the
MemoryMap
buffer. On input, this
is the size of the buffer allocated by the caller. On output, it is the size of
the buffer returned by the firmware if the buffer was large enough, or the
size of the buffer needed to contain the map if the buffer was too small.
MemoryMap
A pointer to the buffer in which firmware places the current memory
map. The map is an array of
EFI_MEMORY_DESCRIPTOR
s. See
“Related Definitions”.
MapKey
A pointer to the location in which firmware returns the key for the
current memory map.
DescriptorSize
A pointer to the location in which firmware returns the size, in bytes, of
an individual
EFI_MEMORY_DESCRIPTOR
.
DescriptorVersion
A pointer to the location in which firmware returns the version number
associated with the
EFI_MEMORY_DESCRIPTOR
. See “Related
Definitions”.