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 マネージャーは、失敗したデバイスの PnP 状態を照会する IRP を送信します。 Flags が STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE に設定され、STORPORT_MARK_DEVICE_FAILED_FLAG_PREDICTED_FAILUREに設定されていない場合、PnP マネージャーは失敗したデバイスの削除を試みます。

要件

要件 値
サポートされている最小のクライアント Windows 10 バージョン 2004
Header storport.h

こちらもご覧ください

IoInvalidateDeviceState

StorPortMarkDeviceFailed