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

Статья
02/07/2025

Подпрограмма 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

Указывает поведение, запрашиваемое мини-портом. Флаги можно задать для одного из следующих значений.

Флаг	Значение
STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE	Удалите неудачное устройство.
STORPORT_MARK_DEVICE_FAILED_FLAG_PREDICTED_FAILURE	Указывает, что это прогнозируемый сбой устройства.

FaultCode

Код сбоя для мини-порта.

FaultDescription

Читаемая человеком строка, описывающая ошибку.

AdditionalDataSize

Размер в байтах буфера, на который Дополнительные данные указывает.

AdditionalData

Указатель на буфер, содержащий дополнительные данные, связанные с условием сбоя.

CriticalDataSize

Размер в байтах буфера, на который Критически важные данные.

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

См. также

IoInvalidateDeviceState

StorPortMarkDeviceFailed

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