Reset SCSI Device Command
Prototype: DWORD SendASPI32Command(LPSRB)
Declaration: LPSRB lpSRB;
The SendASPI32Command function with command code SC_RESET_DEV is used to send a SCSI Bus Device reset to the specified target.
| Parameter |
Description |
| lpSRB |
Points to the following SCSI request block |
typedef struct {
BYTE SRB_Cmd; // ASPI command code = SC_RESET_DEV
BYTE SRB_Status; // ASPI command status byte
BYTE SRB_HaId; // ASPI host adapter number
BYTE SRB_Flags; // Reserved
DWORD SRB_Hdr_Rsvd; // Reserved
BYTE SRB_Target; // Target's SCSI ID
BYTE SRB_Lun; // Target's LUN number
BYTE SRB_Rsvd1[12]; // Reserved for Alignment
BYTE SRB_HaStat; // Host Adapter Status
BYTE SRB_TargStat; // Target Status
void *SRB_PostProc; // Post routine
void *SRB_Rsvd2; // Reserved
BYTE SRB_Rsvd3[32]; // Reserved
} SRB_BusDeviceReset, *PSRB_BusDeviceReset;
Table 4-10. Reset SCSI Device Command
| Member |
Description |
| SRB_Cmd |
[IN] This field must contain SC_RESET_DEV. |
| SRB_Status |
[OUT] This field returns one of the following status: |
| SS_PENDING |
SCSI request is in progress. |
| SS_COMP |
SCSI/ASPI request has completed without error. |
| SS_ABORTED |
SCSI command has been aborted. |
| SS_ABORT_FAIL |
SCSI command abort failed. |
| SS_ERR |
SCSI command completed with an error. |
| SS_INVALID_SRB |
One or more parameters in the SCSI Request Block (SRB) are set incorrectly. |
| SS_INVALID_PATH_ID |
SCSI ID and LUN are invalid. |
| SRB_HaId |
[IN] This field specifies which installed host adapter the request is intended for. Host adapter numbers are always assigned by the SCSI manager layer beginning with zero. |
| SRB_Flags |
[IN] Reserved = 0 |
| SRB_Hdr_Rsvd |
Reserved = 0 |
| SRB_Target |
[IN] SCSI ID of target device. |
| SRB_Lun |
[IN] Logical Unit Number (LUN) of device. This field is ignored by ASPI for Win32, since SCSI Bus Device resets are done on a per-target basis only. |
| SRB_HaStat |
[OUT] Upon completion of the SCSI command, the ASPI manager sets this field with the host adapter status to one of the following values: |
| HASTAT_OK |
Host adapter did not detect an error. |
| HASTAT_TIMEOUT |
The time allocated for the operation expired. |
| HASTAT_COMMAND_TIMEOUT |
SRB expired while waiting to be processed. |
| HASTAT_SEL_TO |
Selection of target timed out. |
| HASTAT_MESSAGE_REJECT |
While processing SRB, the adapter received a MESSAGE REJECT. |
| HASTAT_BUS_RESET |
A bus reset was detected. |
| HASTAT_PARITY_ERROR |
A parity error was detected. |
| HASTAT_REQUEST_SENSE_FAILED |
The adapter failed in issuing a request sense after a check condition was reported by the target device. |
| HASTAT_DO_DU |
Data overrun/underrun. |
| HASTAT_BUS_FREE |
Unexpected Bus Free. |
| HASTAT_PHASE_ERR |
Target Bus phase sequence failure. |
| SRB_TargStat |
[OUT] Upon completion of the SCSI command, the ASPI manager sets this field with the target status as follows: |
| STATUS_GOOD |
No target status. |
| STATUS_CHKCOND |
Check status (sense data is in SenseArea). |
| STATUS_BUSY |
Specified Target/LUN is busy. |
| STATUS_RESCONF |
Reservation conflict. |
| SRB_PostProc |
[IN] If posting is enabled, ASPI for Win32 will post completion of an ASPI request to this function pointer. |
Table 4-11. Return Values from Reset SCSI Device Command
| Value |
Meaning |
| SS_PENDING |
SCSI request is in progress. |
Example
This example issues a SCSI bus device reset to host adapter #0, target #5.
SRB_BusDeviceReset MySRB;
DWORD ASPIStatus;
.
.
MySRB.SRB_Header = SC_RESET_DEV;
MySRB.SRB_HaId = 0;
MySRB.SRB_Flags = 0;
MySRB.SRB_Hdr_Rsvd = 0;
MySRB.SRB_Target = 5;
MySRB.SRB_Lun = 0;
ASPIStatus = SendASPI32Command ( (LPSRB) &MySRB );
.
.