Exitbootservices() - Intel Extensible Firmware Interface Specification

Extensible Firmware Interface Specification
3.4.6

ExitBootServices()

Summary
Terminates all boot services.
Prototype
EFI_STATUS
ExitBootServices (
IN EFI_HANDLE
IN UINTN
);
Parameters
ImageHandle
MapKey
Description
The
ExitBootServices()
to terminate all boot services. On success, the loader becomes responsible for the continued
operation of the system.
An EFI OS loader must ensure that it has the system's current memory map at the time it calls
ExitBootServices(). This is done by passing in the current memory map's
as returned by GetMemoryMap(). Care must be taken to ensure that the memory map does not
change between these two calls. It is suggested that GetMemoryMap()be called immediately
before calling ExitBootServices().
On success, the EFI OS loader owns all available memory in the system. In addition, the loader can
treat all memory in the map marked as
EfiBootServicesData
EFI device-handle-based protocols may be used, and the boot serviceswatchdog timer is disabled.
Status Codes Returned
EFI_SUCCESS
EFI_INVALID_PARAMETER
76
ImageHandle,
MapKey
Handle that identifies the exiting image. Type
in Section 3.3.1.
Key to the latest memory map.
function is called by the currently executing EFI OS loader image
EfiBootServicesCode
as available free memory. No further calls to boot service functions or
Boot services have been terminated.
is incorrect.
MapKey
12/12/00
is defined
EFI_HANDLE
value
MapKey
and
Version 1.02