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 状态。 如果 Flags 设置为 STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE 且未设置为 STORPORT_MARK_DEVICE_FAILED_FLAG_PREDICTED_FAILURE，则 PnP 管理器将尝试删除失败的设备。

要求

要求 值
最低受支持的客户端 Windows 10 版本 2004
标头 storport.h

另请参阅

IoInvalidateDeviceState

StorPortMarkDeviceFailed