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


Функция StorPortLogError (storport.h)

Подпрограмма StorPortLogError уведомляет драйвер порта о том, что произошла ошибка.

Синтаксис

STORPORT_API VOID StorPortLogError(
  [in]           PVOID               HwDeviceExtension,
  [in, optional] PSCSI_REQUEST_BLOCK Srb,
  [in]           UCHAR               PathId,
  [in]           UCHAR               TargetId,
  [in]           UCHAR               Lun,
  [in]           ULONG               ErrorCode,
  [in]           ULONG               UniqueId
);

Параметры

[in] HwDeviceExtension

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

[in, optional] Srb

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

[in] PathId

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

[in] TargetId

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

[in] Lun

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

[in] ErrorCode

Указывает код ошибки, указывающий одно из следующих значений в качестве типа ошибки.

Значение Значение
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 Указывает, что целевой объект неожиданно отключен.

[in] UniqueId

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

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

None

Remarks

Драйвер порта зановит ошибку в журнал системных событий.

Начиная с Windows 8, параметр Srb может указывать на SCSI_REQUEST_BLOCK или STORAGE_REQUEST_BLOCK. Если идентификатор функции в поле ФункцияSrbSRB_FUNCTION_STORAGE_REQUEST_BLOCK, SRB является STORAGE_REQUEST_BLOCK структурой запроса.

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть storport.h (включая Storport.h)
Библиотека Storport.lib
Правила соответствия DDI StorPortDeprecated(storport)

См. также раздел

SCSI_REQUEST_BLOCK

STORAGE_REQUEST_BLOCK

ScsiPortLogError

StorPortLogSystemEvent