Intel Extensible Firmware Interface Network Router User Manual


  Open as PDF
of 1084
 
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.