Функция 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) |