Share via

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

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

IoInvalidateDeviceState

StorPortMarkDeviceFailed