beautypg.com

Efi_scsi_pass_thru_protocol.getnextdevice(), Getnextdevice() – Intel Extensible Firmware Interface User Manual

Page 530

background image

Extensible Firmware Interface Specification

13-10

12/01/02

Version 1.10

EFI_SCSI_PASS_THRU_PROTOCOL.GetNextDevice()

Summary

Used to retrieve the list of legal Target IDs and LUNs for SCSI devices on a SCSI channel. These
can either be the list SCSI devices that are actually present on the SCSI channel, or the list of legal
Target Ids and LUNs for the SCSI channel. Regardless, the caller of this function must probe the
Target ID and LUN returned to see if a SCSI device is actually present at that location on the SCSI
channel.

Prototype

typedef
EFI_STATUS
(EFIAPI *EFI_SCSI_PASS_THRU_GET_NEXT_DEVICE) (
IN EFI_SCSI_PASS_THRU_PROTOCOL

*This,

IN OUT UINT32

*Target,

IN OUT UINT64

*Lun

);

Parameters

This

A pointer to the

EFI_SCSI_PASS_THRU_PROTOCOL

instance. Type

EFI_SCSI_PASS_THRU_PROTOCOL

is

defined in Section 13.1.

Target

On input, a pointer to the Target ID of a SCSI device present on
the SCSI channel. On output, a pointer to the Target ID of the
next SCSI device present on a SCSI channel. An input value of

0xFFFFFFFF

retrieves the Target ID of the first SCSI device

present on a SCSI channel.

Lun

On input, a pointer to the LUN of a SCSI device present on the
SCSI channel. On output, a pointer to the LUN of the next SCSI
device present on a SCSI channel.