Intel Extensible Firmware Interface - Manual (Page 267)

Protocols — EFI Driver Model
Version 1.10 12/01/02 9-25
EFI_PLATFORM_DRIVER_OVERRIDE_PROTOCOL.GetDriver()
Summary
Retrieves the image handle of the platform override driver for a controller in the system.
Prototype
typedef
EFI_STATUS
(EFIAPI *EFI_PLATFORM_DRIVER_OVERRIDE_GET_DRIVER) (
IN EFI_PLATFORM_DRIVER_OVERRIDE_PROTOCOL
*This,
IN EFI_HANDLE ControllerHandle,
IN OUT EFI_HANDLE *DriverImageHandle
);
Parameters
This A pointer to the EFI_PLATFORM_DRIVER_OVERRIDE_
PROTOCOL instance.
ControllerHandle The device handle of the controller to check if a driver override
exists.
DriverImageHandle On input, a pointer to the previous driver image handle returned
by
GetDriver() . On output, a pointer to the next driver
image handle. Passing in a NULL , will return the first driver
image handle for ControllerHandle .
Description
This function is used to retrieve a driver image handle that is selected in a platform specific manner.
The first driver image handle is retrieved by passing in a
DriverImageHandle value of NULL .
This will cause the first driver image handle to be returned in DriverImageHandle . On each
successive call, the previous value of DriverImageHandle must be passed in. If a call to this
function returns a valid driver image handle, then EFI_SUCCESS is returned. This process is
repeated until EFI_NOT_FOUND is returned. If a DriverImageHandle is passed in that was
not returned on a prior call to this function, then EFI_INVALID_PARAMETER is returned. If
ControllerHandle is not a valid EFI_HANDLE , then EFI_INVALID_PARAMETER is
returned. The first driver image handle has the highest precedence, and the last driver image handle
has the lowest precedence. This ordered list of driver image handles is used by the boot service
ConnectController() to search for the best driver for a controller.