beautypg.com

Efi_simple_pointer.reset(), Reset() – Intel Extensible Firmware Interface User Manual

Page 342

background image

Extensible Firmware Interface Specification

10-48

12/01/02

Version 1.10

EFI_SIMPLE_POINTER.Reset()

Summary

Resets the pointer device hardware.

Prototype

typedef

EFI_STATUS

(EFIAPI *EFI_SIMPLE_POINTER_RESET) (

IN EFI_SIMPLE_POINTER_PROTOCOL

*This,

IN BOOLEAN

ExtendedVerification

);

Parameters

This

A pointer to the

EFI_SIMPLE_POINTER_PROTOCOL

instance. Type

EFI_SIMPLE_POINTER_PROTOCOL

is

defined in Section 10.10.

ExtendedVerification

Indicates that the driver may perform a more exhaustive
verification operation of the device during reset.

Description

This

Reset()

function resets the pointer device hardware.

As part of initialization process, the firmware/device will make a quick but reasonable attempt to
verify that the device is functioning. If the

ExtendedVerification

flag is

TRUE

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

The device was reset.

EFI_DEVICE_ERROR

The device is not functioning correctly and could not be reset.