Simple_Text_Output.reset() - Intel Extensible Firmware Interface Specification

Extensible Firmware Interface Specification
7.5.1

SIMPLE_TEXT_OUTPUT.Reset()

Summary
Resets the text output device hardware.
Prototype
EFI_STATUS
(EFIAPI *EFI_TEXT_RESET) (
IN SIMPLE_TEXT_OUTPUT_INTERFACE *This,
IN BOOLEAN
);
Parameters
This
ExtendedVerification
Description
The function resets the text output device hardware. The cursor position is set to (0, 0),
Reset()
and the screen is cleared to the default background color for the output device.
As part of initialization process, the firmware/device will make a quick but reasonable attempt to
verify that the device is functioning. If the
firmware may take an extended amount of time to verify the device is operating on reset.
Otherwise the reset operation is to occur as quickly as possible.
The hardware verification process is not defined by this specification and is left up to the platform
firmware and/or EFI driver to implement.
Status Codes Returned
EFI_SUCCESS
EFI_DEVICE_ERROR
160
A pointer to the
SIMPLE_TEXT_OUTPUT_INTERFACE
instance. Type
SIMPLE_TEXT_OUTPUT_INTERFACE
defined in Section 7.5.
Indicates that the driver may perform a more exhaustive
verification operation of the device during reset.
ExtendedVerification
The text output device was reset.
The text output device is not functioning correctly and could not be reset.
12/12/00
ExtendedVerification
flag is
TRUE
Version 1.02
is
the