2 efi platform driver override protocol, Efi_platform_driver_override_protocol, Platform_driver_override – Intel Extensible Firmware Interface User Manual

Page 265: Platform driver override protocol

Advertising
background image

Protocols

— EFI Driver Model

Version 1.10

12/01/02

9-23

9.2 EFI Platform Driver Override Protocol

This section provides a detailed description of the

EFI_PLATFORM_DRIVER_OVERRIDE_

PROTOCOL

. This protocol can override the default algorithm for matching drivers to controllers.

EFI_PLATFORM_DRIVER_OVERRIDE_PROTOCOL

Summary

This protocol matches one or more drivers to a controller. A platform driver produces this protocol,

and it is installed on a separate handle. This protocol is used by the

ConnectController()

boot service to select the best driver for a controller. All of the drivers returned by this protocol
have a higher precedence than drivers found from an EFI Bus Specific Driver Override Protocol or
drivers found from the general EFI Driver Binding search algorithm. If more than one driver is
returned by this protocol, then the drivers are returned in order from highest precedence to lowest
precedence.

GUID

#define EFI_PLATFORM_DRIVER_OVERRIDE_PROTOCOL_GUID \

{ 0x6b30c738,0xa391,0x11d4,0x9a,0x3b,0x00,0x90,0x27,0x3f,0xc1,0x4d }

Protocol Interface Structure

typedef struct _EFI_PLATFORM_DRIVER_OVERRIDE_PROTOCOL {
EFI_PLATFORM_DRIVER_OVERRIDE_GET_DRIVER

GetDriver;

EFI_PLATFORM_DRIVER_OVERRIDE_GET_DRIVER_PATH

GetDriverPath;

EFI_PLATFORM_DRIVER_OVERRIDE_DRIVER_LOADED

DriverLoaded;

} EFI_PLATFORM_DRIVER_OVERRIDE_PROTOCOL;

Parameters

GetDriver

Retrieves the image handle of a platform override driver for a
controller in the system. See the

GetDriver()

function

description.

GetDriverPath

Retrieves the device path of a platform override driver for a
controller in the system. See the

GetDriverPath()

function

description.

DriverLoaded

This function is used after a driver has been loaded using a
device path returned by

GetDriverPath()

. This function

associates a device path to an image handle, so the image handle
can be returned the next time that

GetDriver()

is called for

the same controller. See the

DriverLoaded()

function

description.

Advertising