Efi_scsi_pass_thru_protocol.gettargetlun(), Gettargetlun(), Func – Intel Extensible Firmware Interface User Manual
Page 534
Extensible Firmware Interface Specification
13-14
12/01/02
Version 1.10
EFI_SCSI_PASS_THRU_PROTOCOL.GetTargetLun()
Summary
Used to translate a device path node to a Target ID and LUN.
Prototype
typedef
EFI_STATUS
(EFIAPI *EFI_SCSI_PASS_THRU_GET_TARGET_LUN) (
IN EFI_SCSI_PASS_THRU_PROTOCOL
*This,
IN EFI_DEVICE_PATH_PROTOCOL
*DevicePath
OUT UINT32
*Target,
OUT UINT64
*Lun
);
Parameters
This
A pointer to the
instance. Type
EFI_SCSI_PASS_THRU_PROTOCOL
is
defined in Section 13.1.
DevicePath
A pointer to the device path node that describes a SCSI device
on the SCSI channel.
Target
A pointer to the Target ID of a SCSI device on the SCSI channel.
Lun
A pointer to the LUN of a SCSI device on the SCSI channel.
Description
The
EFI_SCSI_PASS_THRU_PROTOCOL.GetTargetLun()
function determines the Target
ID and LUN associated with the SCSI device described by
DevicePath
. If
DevicePath
is a
device path node type that the SCSI Pass Thru driver supports, then the SCSI Pass Thru driver will
attempt to translate the contents
DevicePath
into a Target ID and LUN. If this translation is
successful, then that Target ID and LUN are returned in
Target
and
Lun
, and
EFI_SUCCESS
is
returned.
If
DevicePath
,
Target
, or
Lun
are
NULL
, then
EFI_INVALID_PARAMETER
is returned.
If
DevicePath
is not a device path node type that the SCSI Pass Thru driver supports, then
EFI_UNSUPPORTED
is returned.
If
DevicePath
is a device path node type that the SCSI Pass Thru driver supports, but there
is not a valid translation from
DevicePath
to a Target ID and LUN, then
EFI_NOT_FOUND
is returned.