Функция 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 и сопоставленные диапазоны доступа для 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.
Возвращаемое значение
Никакой
Замечания
Драйвер порта регистрирует ошибку в системном журнале событий.
Начиная с Windows 8 параметр Srb может указывать на SCSI_REQUEST_BLOCK или STORAGE_REQUEST_BLOCK. Если идентификатор функции в поле функции SrbSRB_FUNCTION_STORAGE_REQUEST_BLOCK, SRB является структурой запросов STORAGE_REQUEST_BLOCK.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| заголовка | storport.h (include Storport.h) |
| библиотеки | Storport.lib |
| правил соответствия DDI | StorPortDeprecated(storport) |