beautypg.com

Efi_driver_configuration_protocol.forcedefaults(), Forcedefaults(), Func – Intel Extensible Firmware Interface User Manual

Page 282

background image

Extensible Firmware Interface Specification

9-40

12/01/02

Version 1.10

EFI_DRIVER_CONFIGURATION_PROTOCOL.ForceDefaults()

Summary

Forces a driver to set the default configuration options for a controller.

Prototype

typedef
EFI_STATUS
(EFIAPI *EFI_DRIVER_CONFIGURATION_FORCE_DEFAULTS) (
IN EFI_DRIVER_CONFIGURATION_PROTOCOL

*This,

IN EFI_HANDLE

ControllerHandle,

IN EFI_HANDLE

ChildHandle OPTIONAL,

IN UINT32

DefaultType,

OUT EFI_DRIVER_CONFIGURATION_ACTION_REQUIRED

*ActionRequired

);

Parameters

This

A pointer to the

EFI_DRIVER_CONFIGURATION_

PROTOCOL

instance.

ControllerHandle

The handle of the controller to force default configuration
options on.

ChildHandle

The handle of the child controller to force default configuration
options on. This is an optional parameter that may be

NULL

. It

will be

NULL

for device drivers. It will also be

NULL

for a bus

drivers that wish to force default configuration options for the
bus controller. It will not be

NULL

for a bus driver that wishes

to force default configuration options for one of its child
controllers.

DefaultType

The type of default configuration options to force on the
controller specified by

ControllerHandle

and

ChildHandle

. See Table 9-1 for legal values. A

DefaultType

of 0x00000000 must be supported by this

protocol.

ActionRequired

A pointer to the action that the calling agent is required to
perform when this function returns. See “Related Definitions” in
the

SetOptions()

function description for a list of the actions

that the calling agent is required to perform prior to accessing

ControllerHandle

again.