Error Handling

A SCSI miniport driver is responsible for handling and for notifying the port driver of the following kinds of SCSI errors, which should be set in the SrbStatus field before the driver completes the SRB it was processing when the error occurred:

• SRB_STATUS_ERROR (if the HBA returns a nonspecific bus error)
• SRB_STATUS_PARITY_ERROR
• SRB_STATUS_UNEXPECTED_BUS_FREE
• SRB_STATUS_SELECTION_TIMEOUT
• SRB_STATUS_COMMAND_TIMEOUT
• SRB_STATUS_MESSAGE_REJECTED
• SRB_STATUS_NO_DEVICE
• SRB_STATUS_NO_HBA
• SRB_STATUS_DATA_OVERRUN (also returned for underruns)
• SRB_STATUS_PHASE_SEQUENCE_FAILURE
• SRB_STATUS_BUSY (TID busy)

For a data underrun, the miniport driver must update the SRB's DataTransferLength to indicate how much data actually was transferred.

Whenever the miniport driver encounters an HBA or bus error, it should call ScsiPortLogError with one of the following system-defined error codes:

• SP_BUS_PARITY_ERROR
• SP_UNEXPECTED_DISCONNECT (by the target LU)
• SP_INVALID_RESELECTION
• SP_BUS_TIME_OUT
• SP_REQUEST_TIMEOUT
• SP_PROTOCOL_ERROR
• SP_INTERNAL_ADAPTER_ERROR
• SP_IRQ_NOT_RESPONDING (if the miniport detects that the HBA is no longer generating interrupts)
• SP_BAD_FW_ERROR ("FW" stands for "firmware")
• SP_BAD_FW_WARNING

ScsiPortLogError allocates an error-log packet, sets it up, and logs the I/O error on behalf of the miniport driver to help users or system administrators monitor the condition of the HBA.