Unloadimage() - Intel Extensible Firmware Interface Specification

Extensible Firmware Interface Specification
3.4.3

UnloadImage()

Summary
Unloads an image.
Prototype
EFI_STATUS
UnloadImage (
IN EFI_HANDLE
);
Parameters
ImageHandle
Description
The
UnloadImage()
There are three possible scenarios. If the image has not been started, the function unloads the
image and returns EFI_SUCCESS.
If the image has been started and has an
point. If the image's unload function returns EFI_SUCCESS, the image is unloaded; otherwise,
the error returned by the image's unload function is returned to the caller. The image unload
function is responsible for freeing all allocated memory and ensuring that there are no references to
any freed memory, or to the image itself, before returning EFI_SUCCESS.
If the image has been started and does not have an
EFI_UNSUPPORTED.
Status Codes Returned
EFI_SUCCESS
EFI_UNSUPPORTED
EFI_INVALID_PARAMETER
Exit code from Unload handler
72
Handle that identifies the image to be unloaded. Type
defined in Section 3.3.1.
function unloads a previously loaded image.
Unload()
The image has been unloaded.
The image has been started, and does not support unload.
ImageHandle
is not a valid image handle.
Exit code from image's unload function.
12/12/00
ImageHandle
entry point, control is passed to that entry
entry point, the function returns
Unload()
is
EFI_HANDLE
Version 1.02