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

デバイスの障害の理由とその他の詳細を指定する文字列。

戻り値

なし

解説

ミニポート ドライバーは、この関数を呼び出して、失敗したデバイスをマークできます。 STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICEが Flags で設定されていない場合、Storport はイベントのみをログに記録します。

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

要件

要件
Header storport.h

こちらもご覧ください

IoInvalidateDeviceState

StorPortMarkDeviceFailedEx