beautypg.com

Description – Intel Extensible Firmware Interface User Manual

Page 283

background image

Protocols

— EFI Driver Model

Version 1.10

12/01/02

9-41

Description

This function forces the default configuration options specified by

DefaultType

for the driver

specified by

This

on the controller specified by

ControllerHandle

and

ChildHandle

.

This function is not allowed to interact with the user. If the controller specified by

ControllerHandle

and

ChildHandle

is not supported by the driver specified by

This

,

then

EFI_UNSUPPORTED

is returned. If the configuration type specified by

DefaultType

is

not supported, then

EFI_UNSUPPORTED

is returned. If a device error occurs while setting the

default configuration options,

EFI_DEVICE_ERROR

is returned. If there are not enough

resources available to set the default configuration options, then

EFI_OUT_OF_RESOURCES

is

returned.

The

ActionRequired

return value must always be set to a legal value by this function. The

caller must perform the required action regardless of the return status. The calling agent must also
perform the action described by

ActionRequired

prior to using any of the services produced by

ControllerHandle

or any of its children.

Table 9-1.

EFI Driver Configuration Default Type

Bits

Description

Bit 0-15

0x0000

0x0001

0x0002

0x0003

If bits 16-31 are 0x0000, then the following values are defined:

Safe Defaults

. This type must be supported by all implementations of the

EFI_DRIVER_CONFIGURATION_PROTOCOL. It places a controller a safe configuration that
has the greatest probability of functioning correctly in a platform.

Manufacturing Defaults

. Optional type that places the controller in a configuration suitable

for a manufacturing and test environment.

Custom Defaults

. Optional type that places the controller in a custom configuration.

Performance Defaults

. Optional type that places the controller in a configuration the

maximizes the controller’s performance in a platform.

All other values are reserved for future versions of the EFI Specification.

Bits16-31

A value of 0x0000 is reserved by this specification. Values 0x0001-0xFFFF are available for
expansion by third parties.