Fibre Channel SNIA HBA API Programmer's Guide

HBA_UINT32 sense_buffer_size
);
Purpose: Sends a SCSI Inquiry command to a remote WWN.
Input Parameters: handle - Handle to an adapter already opened by call to
HBA_OpenAdapter().
port_wwn - Port WWN of a remote port.
fc_lun - Specific FC LUN to send inquiry to.
evpd- Set to 0 to return standard SCSI INQUIRY data. Set to 1 to
return the vital product data specified by the page code.
page_code - If evpd is 1, the vital product data page code to
request.
rsp_buffer_size - Size of buffer to receive the response.
sense_buffer_size - Size of buffer to receive sense data.
Output Parameters: p_rsp_buffer - Pointer to a buffer to receive response.
p_sense_buffer - Pointer to a buffer to receive sense data.
Return Values: Returned after a
successful execution of the
call.
HBA_STATUS_OK
HBA_STATUS_ERROR
Returned when a internal
library or system error is
detected.
HBA_STATUS_ERROR_BUSY
Returned when the library
is busy and cannot
currently process this call.
HBA_STATUS_ERROR_INVALID_HANDLE
Returned when the handle
passed to this function is
invalid.
HBA_STATUS_ERROR_ARG
Returned when any of the
pointers passed to this
function are NULL, or
when evpd has an invalid
value.
HBA_STATUS_ERROR_UNAVAILABLE
Returned when the
adapter to which the
handle corresponds is not
available.
HBA_STATUS_ERROR_ILLEGAL_WWN
Returned when the WWN
given as input does not
match the WWN of any
discovered port.
HBA_STATUS_ERROR_MORE_DATA
Returned when any of the
allocated buffers is
insufficient.
HBA_STATUS_SCSI_CHECK_CONDITION
Returned when a SCSI
check condition occurs
and there is valid sense
data in the SenseBuffer.
Call order sequence: See Appendix A.
SCSI Informational Functions 31