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

指出迷你埠所要求的行為。 旗標 可以設定為下列其中一個值。

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 管理員會嘗試移除失敗的裝置。

規格需求

另請參閱

IoInvalidateDeviceState

StorPortMarkDeviceFailed