beautypg.com

Driverloaded(), Func, Ted, the – Intel Extensible Firmware Interface User Manual

Page 271: Serv

background image

Protocols

— EFI Driver Model

Version 1.10

12/01/02

9-29

EFI_PLATFORM_DRIVER_OVERRIDE_PROTOCOL.DriverLoaded()

Summary

Used to associate a driver image handle with a device path that was returned on a prior call to the

GetDriverPath()

service. This driver image handle will then be available through the

GetDriver()

service.

Prototype

typedef
EFI_STATUS
(EFIAPI *EFI_PLATFORM_DRIVER_OVERRIDE_DRIVER_LOADED) (
IN EFI_PLATFORM_DRIVER_OVERRIDE_PROTOCOL

*This,

IN EFI_HANDLE

ControllerHandle,

IN EFI_DEVICE_PATH_PROTOCOL

*DriverImagePath,

IN EFI_HANDLE

DriverImageHandle

);

Parameters

This

A pointer to the

EFI_PLATFORM_DRIVER_OVERRIDE_

PROTOCOL

instance.

ControllerHandle

The device handle of a controller. This must match the
controller handle that was used in a prior call to

GetDriver()

to retrieve

DriverImagePath

.

DriverImagePath

A pointer to the driver device path that was returned in a prior
call to

GetDriverPath()

.

DriverImageHandle

The driver image handle that was returned by

LoadImage()

when the driver specified by

DriverImagePath

was loaded

into memory.

Description

This function associates the image handle specified by

DriverImageHandle

with the device

path of a driver specified by

DriverImagePath

.

DriverImagePath

must be a value that

was returned on a prior call to

GetDriverPath()

for the controller specified by

ControllerHandle

. Once this association has been established, then the service

GetDriver()

must return

DriverImageHandle

as one of the override drivers for the

controller specified by

ControllerHandle

.