Функция ScsiPortLogError (srb.h)

Статья
02/07/2025

ScsiPortLogError ошибок в журнал событий системы, когда мини-драйвер или его HBA обнаруживает условие ошибки SCSI.

Заметка

В будущем драйвер портов SCSI и модели драйверов мини-порта SCSI могут быть изменены или недоступны. Используйте драйвера Storport и модели драйверов Storport miniport.

Синтаксис

SCSIPORT_API VOID ScsiPortLogError(
  PVOID               HwDeviceExtension,
  PSCSI_REQUEST_BLOCK Srb,
  UCHAR               PathId,
  UCHAR               TargetId,
  UCHAR               Lun,
  ULONG               ErrorCode,
  ULONG               UniqueId
);

Параметры

HwDeviceExtension

[in] Указатель на расширение аппаратного устройства. Это область хранения на уровне HBA, которую драйвер портов выделяет и инициализирует от имени мини-порта. Мини-порты обычно хранят сведения, относящиеся к HBA, в этом расширении, например состояние HBA и сопоставленные диапазоны доступа HBA. Эта область доступна мини-драйверу в DeviceExtension->HwDeviceExtension член объекта устройства HBA сразу после вызова мини-порта драйвера ScsiPortInitialize. Драйвер портов освобождает эту память при удалении устройства.

Srb

[in, необязательный] Указатель на блок запроса SCSI, если он связан с ошибкой. В противном случае этот параметр null.

PathId

[in] Определяет шину SCSI.

TargetId

[in] Определяет целевой контроллер или устройство на шине.

Lun

[in] Определяет логическую единицу целевого устройства.

ErrorCode

[in] Указывает код ошибки. Этот параметр может быть одним из следующих значений в качестве типа ошибки.

Ценность	Значение
SP_BAD_FW_ERROR	Указывает, что драйвер обнаружил плохое или старое встроенное ПО. Устройство не будет использоваться.
SP_BAD_FW_WARNING	Указывает, что драйвер обнаружил карточку со старым или плохим встроенном ПО, что может привести к снижению производительности или функциональности.
SP_BUS_PARITY_ERROR	Указывает, что обнаружена ошибка четности шины SCSI.
SP_BUS_TIME_OUT	Указывает время ожидания ШИНЫ SCSI к логическому единице.
SP_INTERNAL_ADAPTER_ERROR	Указывает, что обнаружена внутренняя ошибка HBA.
SP_INVALID_RESELECTION	Указывает, что логическая единица повторно выбрана неожиданно или с недопустимым тегом очереди.
SP_IRQ_NOT_RESPONDING	Указывает, что HBA не прерывается, когда ожидается.
SP_PROTOCOL_ERROR	Указывает, что драйвер минипорта обнаружил ошибку протокола SCSI.
SP_REQUEST_TIMEOUT	Указывает время ожидания операции контроллера.
SP_UNEXPECTED_DISCONNECT	Указывает, что целевой объект отключен неожиданно.

UniqueId

[in] Указывает уникальный идентификатор ошибки. Это значение отличает текущую ошибку от других ошибок с тем же ErrorCode. Для некоторых драйверов минипорта это определяет строку кода, в которой обнаружена ошибка. Для других это дополнительная информация, возвращаемая HBA.

Возвращаемое значение

Никакой

Замечания

Минипорт-драйвер должен регистрировать все реальные ошибки оборудования. Однако не следует регистрировать распространенные операционные ошибки, такие как время ожидания выбора или сбросы шины.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	srb.h (include Miniport.h, Scsi.h)
библиотеки	Scsiport.lib

См. также

ScsiPortNotification

Поделиться через