Intel Extensible Firmware Interface Network Router User Manual


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