Startimage() - Intel Extensible Firmware Interface Specification

3.4.2

StartImage()

Summary
Transfers control to a loaded image's entry point.
Prototype
EFI_STATUS
StartImage (
IN EFI_HANDLE
OUT UINTN
OUT CHAR16
);
Parameters
ImageHandle
ExitDataSize
ExitData
Description
The
StartImage()
LoadImage(). The image may only be started one time.
Control returns from
made, the
ExitData
back through the
ExitData
function is responsible for returning the
when the buffer is no longer needed.
Status Codes Returned
EFI_INVALID_PARAMETER
Exit code from image
Version 1.02
ImageHandle,
*ExitDataSize,
**ExitData OPTIONAL
Handle of image to be started. Type
Section 3.3.1.
Pointer to the size, in bytes, of ExitData.
Pointer to a 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.
function transfers control to the entry point of an image that was loaded by
when the loaded image calls Exit(). When that call is
StartImage()
buffer and
ExitDataSize
buffer and
ExitDataSize
ExitData
ImageHandle
Exit code from image.
EFI_HANDLE
from (see Section 3.4.5) are passed
Exit()
in this function. The caller of this
buffer to the pool by calling
is not a handle to an unstarted image.
12/12/00
Services
is defined in
FreePool()
71