Intel Extensible Firmware Interface - Manual (Page 682)

Extensible Firmware Interface Specification
15-76 12/01/02 Version 1.10
EFI_BIS.Shutdown()
Summary
Shuts down an application’s instance of the BIS service, invalidating the application handle. After
this call, other BIS functions may no longer be invoked using the application handle value.
Prototype
typedef
EFI_STATUS
(EFIAPI *EFI_BIS_SHUTDOWN)(
IN BIS_APPLICATION_HANDLE
AppHandle
);
Parameters
AppHandle An opaque handle that identifies the caller’s instance of
initialization of the BIS service. Type
BIS_APPLICATION_HANDLE is defined in the
Initialize() function description.
Description
This function shuts down an application’s instance of the BIS service, invalidating the application
handle. After this call, other BIS functions may no longer be invoked using the application handle
value.
This function must be paired with a preceding successful call to the Initialize() function.
The lifetime of an application handle extends from the time the handle was returned from
Initialize() until the time the handle is passed to Shutdown() . If there are other remaining
handles whose lifetime is still active, they may still be used in calling BIS functions.
The caller must free all memory resources associated with this AppHandle that were allocated
and returned from other BIS functions before calling Shutdown() . Memory resources are freed
using the Free() function. Failure to free such memory resources is a caller error, however, this
function does not return an error code under this circumstance. Further attempts to access the
outstanding memory resources causes unspecified results.