Locatedevicepath() - Intel Extensible Firmware Interface Specification

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
IN OUT EFI_DEVICE_PATH
OUT EFI_HANDLE
);
Parameters
Protocol
DevicePath
Device
Related Definitions
//*******************************************************
// EFI_DEVICE_PATH
//*******************************************************
typedef struct _EFI_DEVICE_PATH {
UINT8
UINT8
UINT8
} EFI_DEVICE_PATH;
Version 1.02
*Protocol,
**DevicePath,
*Device
The protocol to search for. Type
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
Definitions".
A pointer to the returned device handle. Type
in Section 3.3.1.
Type;
SubType;
Length[2];
12/12/00
is defined in Section 3.3.1.
EFI_GUID
is defined in "Related
EFI_HANDLE
Services
is defined
65