Exit() - Intel Extensible Firmware Interface Specification

Extensible Firmware Interface Specification
3.4.5

Exit()

Summary
Terminates the currently loaded EFI image and returns control to boot services.
Prototype
EFI_STATUS
Exit (
IN EFI_HANDLE
IN EFI_STATUS
IN UINTN
IN CHAR16
);
Parameters
ImageHandle
ExitStatus
ExitDataSize
ExitData
Description
The function terminates the image referenced by
Exit()
boot services. This function can only be called by the currently executing image. This function
may not be called if the image has already returned from its entry point
(EFI_IMAGE_ENTRY_POINT) or if it has loaded any child images that have not exited (all child
images must exit before this image can exit).
Using is similar to returning from the image's
Exit()
may also return additional ExitData.
Exit()
74
ImageHandle,
ExitStatus,
ExitDataSize,
*ExitData OPTIONAL
Handle that identifies the image. This parameter is passed to the image
on entry. Type
EFI_HANDLE
The image's exit code.
The size, in bytes, of ExitData. Ignored if
EFI_SUCCESS.
Pointer to a data buffer that includes a Null-terminated Unicode string,
optionally followed by additional binary data. The string is a description
that the caller may use to further indicate the reason for the image's exit.
is only valid if
ExitData
EFI_SUCCESS. The
ExitData
AllocatePool(). (See Section 3.2.4.)
12/12/00
is defined in Section 3.3.1.
ExitStatus
is something other than
ExitStatus
buffer must be allocated by calling
and returns control to
ImageHandle
EFI_IMAGE_ENTRY_POINT
is
except that
Version 1.02