4 efi driver configuration protocol, Efi_driver_configuration_protocol, Driver_configuration – Intel Extensible Firmware Interface User Manual

Page 275: Driver, Configuration protocol

Advertising
background image

Protocols

— EFI Driver Model

Version 1.10

12/01/02

9-33

9.4 EFI Driver Configuration Protocol

This section provides a detailed description of the

EFI_DRIVER_CONFIGURATION_

PROTOCOL

. This is a protocol that allows an EFI Driver to provide the ability to set controller

specific options on a controller that the driver is managing. Unlike legacy option ROMs, the
configuration of drivers and controllers is delayed until a platform management utility chooses to
use the services of this protocol. EFI Drivers are not allowed to perform setup-like operations
outside the context of this protocol. This means that a driver is not allowed to interact with the user
outside the context of this protocol.

EFI_DRIVER_CONFIGURATION_PROTOCOL

Summary

Used to set configuration options for a controller that an EFI Driver is managing.

GUID

#define EFI_DRIVER_CONFIGURATION_PROTOCOL_GUID \

{ 0x107a772b,0xd5e1,0x11d4,0x9a,0x46,0x0,0x90,0x27,0x3f,0xc1,0x4d }

Protocol Interface Structure

typedef struct _EFI_DRIVER_CONFIGURATION_PROTOCOL {
EFI_DRIVER_CONFIGURATION_SET_OPTIONS

SetOptions;

EFI_DRIVER_CONFIGURATION_OPTIONS_VALID

OptionsValid;

EFI_DRIVER_CONFIGURATION_FORCE_DEFAULTS

ForceDefaults;

CHAR8

*SupportedLanguages;

} EFI_DRIVER_CONFIGURATION_PROTOCOL;

Parameters

SetOptions

Allows the use to set drivers specific configuration options for a
controller that the driver is currently managing. See the

SetOptions()

function description.

OptionsValid

Tests to see if a controller’s current configuration options are
valid. See the

OptionsValid()

function description.

ForceDefaults

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

ForceDefaults()

function description.

SupportedLanguages

A Null-terminated ASCII string that contains one or more
ISO 639-2 language codes. This is the list of language codes
that this protocol supports.

Advertising