Allocatepool() - Intel Extensible Firmware Interface Specification

3.2.4

AllocatePool()

Summary
Allocates pool memory.
Prototype
EFI_STATUS
AllocatePool (
IN EFI_MEMORY_TYPE
IN UINTN
OUT VOID
);
Parameters
PoolType
Size
Buffer
Description
The
AllocatePool()
and returns the address of the allocated memory in the location referenced by Buffer.
PoolType
This function allocates pages from
pool type. All allocations are eight-byte aligned.
The allocated pool memory is returned to the available pool with the
Status Codes Returned
EFI_SUCCESS
EFI_OUT_OF_RESOURCES
EFI_INVALID_PARAMETER
Version 1.02
PoolType,
Size,
**Buffer
The type of pool to allocate. The only supported types are
EfiLoaderData, EfiBootServicesData,
EfiRuntimeServicesData, EfiACPIReclaimMemory,
EfiACPIMemoryNVS. Type
Section 3.2.1.
The number of bytes to allocate from the pool.
A pointer to a pointer to the allocated buffer if the call succeeds;
undefined otherwise.
function allocates a memory region of
EfiConventionalMemory
The requested number of bytes was allocated.
The pool requested could not be allocated.
PoolType
was invalid.
12/12/00
is defined in
EFI_MEMORY_TYPE
bytes from memory of type
Size
as needed to grow the requested
FreePool()
Services
and
function.
53