Intel Extensible Firmware Interface 3.3.7 LocateDevicePath()

Services
Version 1.02 12/12/00 65
3.3.7 LocateDevicePath()
Summary
Locates the handle to a device on the device path that supports the specified protocol.
Prototype
EFI_STATUS
LocateDevicePath (
IN EFI_GUID *Protocol,
IN OUT EFI_DEVICE_PATH **DevicePath,
OUT EFI_HANDLE *Device
);
Parameters
Protocol The protocol to search for. Type EFI_GUID is defined in Section 3.3.1.
DevicePath On input, a pointer to a pointer to the device path. On output, the device
path pointer is modified to point to the remaining part of the device path
— that is, when the function finds the closest handle, it splits the device
path into two parts, stripping off the front part, and returning the
remaining portion. Type EFI_DEVICE_PATH is defined in “Related
Definitions”.
Device A pointer to the returned device handle. Type EFI_HANDLE is defined
in Section 3.3.1.
Related Definitions
//*******************************************************
// EFI_DEVICE_PATH
//*******************************************************
typedef struct _EFI_DEVICE_PATH {
UINT8 Type;
UINT8 SubType;
UINT8 Length[2];
} EFI_DEVICE_PATH;