共用方式為

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程序代碼。

言論

迷你埠驅動程式可以呼叫此函式來標示失敗的裝置，或指出裝置可能失敗。

如果未在 Flags中設定旗標，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