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 |