Intel Extensible Firmware Interface, Specification

Page: 84 / 494

Extensible Firmware Interface Specification
66 12/12/00 Version 1.02
Description
The
LocateDevicePath()
function locates all devices on
DevicePath
that support
Protocol
and returns the handle to the device that is closest to
DevicePath
.
DevicePath
is
advanced over the device path nodes that were matched.
This function is useful for locating the proper instance of a protocol interface to use from a logical
parent device driver. For example, a target device driver may issue the request with its own device
path and locate the interfaces to perform IO on its bus. It can also be used with a device path that
contains a file path to strip off the file system portion of the device path, leaving the file path and
handle to the file system driver needed to access the file.
If the handle for
DevicePath
supports the protocol (a direct match), the resulting device path is
advanced to the device path terminator node.
Status Codes Returned
EFI_SUCCESS The resulting handle was returned.
EFI_NOT_FOUND No handles matched the search.
EFI_INVALID_PARAMETER One of the parameters has an invalid value.