UfxDeviceNotifyHardwareFailure 関数 (ufxclient.h)

  • [アーティクル]

コントローラーで回復できないハードウェア障害について UFX に通知します。

構文

void UfxDeviceNotifyHardwareFailure(
  [in]           UFXDEVICE                     UfxDevice,
  [in, optional] PUFX_HARDWARE_FAILURE_CONTEXT HardwareFailureContext
);

パラメーター

[in] UfxDevice

ドライバーが UfxDeviceCreate を呼び出して作成した UFX デバイス オブジェクトへのハンドル。

[in, optional] HardwareFailureContext

ハードウェア障害に関するコントローラー固有の情報を含むクライアント ドライバー定義 のUFX_HARDWARE_FAILURE_CONTEXT 構造体へのポインター (省略可能)。

戻り値

なし

解説

クライアント ドライバーは、コントローラーが回復不可能なハードウェア 障害 (PHY ロックアップなど) に入ったときに UfxDeviceNotifyHardwareFailure を呼び出します。 UFX は、コントローラーをリセットして、コントローラーを回復できるかどうかを確認できます。 次の例は、 呼び出しの構文を示しています。

    UfxDeviceNotifyHardwareFailure(
        ControllerContext->UfxDevice,
        (PUFX_HARDWARE_FAILURE_CONTEXT) HardwareFailureContext);

要件

要件 値
サポートされている最小のクライアント Windows 10
対象プラットフォーム Windows
ヘッダー ufxclient.h
Library ufxstub.lib
IRQL DISPATCH_LEVEL