Specifications

34 Version 2.0
EFI_SHELL_PROTOCOL.GetMapFromDevicePath()
Summary
Gets the mapping that most closely matches the device path.
Prototype
typedef
CONST CHAR16 *
(EFIAPI *EFI_SHELL_GET_MAP_FROM_DEVICE_PATH) (
IN OUT EFI_DEVICE_PATH_PROTOCOL **DevicePath
);
Parameters
DevicePath
On entry, points to a device path pointer. On exit, updates the pointer to point to
the portion of the device path after the mapping.
Description
This function gets the mapping which corresponds to the device path *DevicePath. If
there is no exact match, then the mapping which most closely matches *DevicePath
is returned, and *DevicePath is updated to point to the remaining portion of the
device path. If there is an exact match, the mapping is returned and *DevicePath
points to the end-of-device-path node.
Returned Value
!NULL Pointer to null-terminated mapping. The buffer is callee-
allocated and should be freed by the caller.
NULL No mapping was found.