通过

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

指示微型端口请求的行为。 标志 可以设置为以下值之一。

旗 意义
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