HBA_SendScsiInquiry routine
The HBA_SendScsiInquiry routine sends a SCSI inquiry command to the indicated remote port.
Syntax
HBA_STATUS HBA_API HBA_SendScsiInquiry(
_In_ HBA_HANDLE handle,
_In_ HBA_WWN portWWN,
_In_ HBA_UINT64 fcLUN,
_In_ HBA_UINT8 EVPD,
_In_ HBA_UINT32 PageCode,
_Out_ void *pRspBuffer,
_In_ HBA_UINT32 pRespBufferSize,
_Out_ void *pSenseBuffer,
_In_ HBA_UINT32 SenseBufferSize
);
Parameters
handle [in]
Contains a value returned by the routine HBA_OpenAdapter that identifies the HBA on which the target port is located.portWWN [in]
Contains a 64-bit worldwide name (WWN) that uniquely identifies the remote target port to which the SCSI inquiry command is sent. For a discussion of worldwide names, see the T11 committee's Fibre Channel HBA API specification.fcLUN [in]
Indicates the fibre channel logical unit number of the logical unit to which the SCSI inquiry command is sent.EVPD [in]
Indicates, when 0, that the inquiry command retrieves the standard SCSI inquiry data. When this member is set to 1, it indicates the inquiry command retrieves the vital product data (VPD) specified by PageCode.PageCode [in]
Indicates the VPD page code to retrieve when EVPD is set to 1. If EVPD is not set to 1, PageCode is ignored.pRspBuffer [out]
Pointer to a buffer that receives the output data of the SCSI inquiry command.pRespBufferSize [in]
Indicates the size, in bytes, of the buffer at pRspBuffer.pSenseBuffer [out]
Pointer to a buffer that receives the SCSI sense data.SenseBufferSize [in]
On input, indicates the size, in bytes, of the buffer at pSenseBuffer. On output, this member indicates the number of bytes of sense data returned.
Return value
The HBA_SendScsiInquiry routine returns a value of type HBA_STATUS that indicates the status of the HBA. In particular, HBA_SendScsiInquiry returns one of the following values.
| Return code | Description |
|---|---|
| HBA_STATUS_OK | Returned if the complete payload of a reply to the SCSI inquiry command was successfully retrieved. |
| HBA_STATUS_ERROR_NOT_A_TARGET | Returned if the specified remote port specified by portWWN does not have SCSI target functionality. |
| HBA_STATUS_ERROR_TARGET_BUSY | Returned if the SCSI inquiry command could not be delivered without causing a SCSI overlapped command condition. |
| HBA_STATUS_SCSI_CHECK_CONDITION | Returned if a SCSI check condition occurred and SCSI send data is provided in the buffer at pSenseBuffer. |
| HBA_STATUS_ERROR | Returned if an unspecified error occurred that prevented the execution of the SCSI inquiry command. |
Requirements
Target platform |
Desktop |
Header |
Hbaapi.h (include Hbaapi.h) |
Library |
Hbaapi.lib |
DLL |
Hbaapi.dll |
See also