Функция StorPortMarkDeviceFailedEx (storport.h)
Подпрограмма StorPortMarkDeviceFailedEx помечает устройство с состоянием сбоя и предоставляет данные, которые могут потребоваться для диагностики.
Синтаксис
ULONG StorPortMarkDeviceFailedEx(
PVOID HwDeviceExtension,
PSTOR_ADDRESS StorAddress,
ULONG Flags,
USHORT FaultCode,
PWSTR FaultDescription,
USHORT AdditionalDataSize,
PUCHAR AdditionalData,
USHORT CriticalDataSize,
PUCHAR CriticalData
);
Параметры
HwDeviceExtension
Указатель на расширение аппаратного устройства для адаптера шины узла (HBA).
StorAddress
Адрес устройства единицы хранения. Этот параметр имеет значение NULL для устройств адаптера.
Flags
Указывает поведение, запрашиваемое мини-портом. Для флагов можно задать одно из следующих значений.
| Flag | Значение |
|---|---|
| STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE | Удалите устройство, на которое произошел сбой. |
| STORPORT_MARK_DEVICE_FAILED_FLAG_PREDICTED_FAILURE | Указывает, что это прогнозируемый сбой устройства. |
FaultCode
Код ошибки для конкретного мини-порта.
FaultDescription
Удобочитаемая строка, описывающая ошибку.
AdditionalDataSize
Размер буфера, на который указывает AdditionalData , в байтах.
AdditionalData
Указатель на буфер, содержащий дополнительные данные, связанные с условием сбоя.
CriticalDataSize
Размер буфера, на который указывает CriticalData , в байтах.
CriticalData
Указатель на буфер, содержащий критические данные, связанные с условием сбоя.
Возвращаемое значение
StorPortMarkDeviceFailedEx возвращает допустимый код STOR_STATUS.
Комментарии
Драйвер мини-порта может вызвать эту функцию, чтобы отметить устройство, завершившемся сбоем, или указать, что устройство потенциально завершилось сбоем.
Если в разделе Флаги не заданы флаги, Storport регистрирует только событие.
Диспетчер PnP отправит IRP для запроса состояния PnP неработоспособности устройства. Если для флагов задано значение STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE, а не значение STORPORT_MARK_DEVICE_FAILED_FLAG_PREDICTED_FAILURE, диспетчер PnP попытается удалить устройство, на которое произошел сбой.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 10 версии 2004 |
| Верхняя часть | storport.h |