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 狀態。 如果 Flags 設定為 STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE，且未設定為 STORPORT_MARK_DEVICE_FAILED_FLAG_PREDICTED_FAILURE，則 PnP 管理員會嘗試移除失敗的裝置。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 10 (版本 2004) |
| 標頭 | storport.h |