storPortMarkDeviceFailed 函式 (storport.h)

  • 發行項

StorPortMarkDeviceFailed 例程會標示狀態為失敗的裝置。 另請參閱 StorPortMarkDeviceFailedEx。

語法

void StorPortMarkDeviceFailed(
  PVOID         HwDeviceExtension,
  PSTOR_ADDRESS StorAddress,
  ULONG         Flags,
  PWSTR         FailReason
);

參數

HwDeviceExtension

主機總線適配卡的硬體裝置擴充功能指標， (HBA) 。

StorAddress

儲存單位裝置位址。 配接器裝置的此參數為NULL。

Flags

設定為 STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE 以移除失敗的裝置。

FailReason

字串，指定裝置失敗的原因以及其他詳細數據。

傳回值

無

備註

迷你埠驅動程式可以呼叫此函式來標記失敗的裝置。 如果未在 Flags 中設定STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE，Storport 只會記錄事件。

PnP 管理員會傳送 IRP 來查詢失敗裝置的 PnP 狀態。 如果 Flags 設定為 STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE，則 PnP 管理員會嘗試移除失敗的裝置。

規格需求

需求 值
標頭 storport.h

另請參閱

IoInvalidateDeviceState

StorPortMarkDeviceFailedEx