Intel Extensible Firmware Interface - Manual (Page 146)

Extensible Firmware Interface Specification
5-48 12/01/02 Version 1.10
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 I/O 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.