EngHangNotification 関数 (winddi.h)

  • [アーティクル]

EngHangNotification 関数は、指定されたデバイスが動作不能または応答できないことをシステムに通知します。

構文

ENGAPI ULONG EngHangNotification(
  HDEV  hdev,
  PVOID Reserved
);

パラメーター

hdev

停止した物理デバイスへのハンドル。 このパラメーターは、ドライバーの DrvCompletePDEV エントリ ポイントによって受信される GDI ハンドルです。

Reserved

は予約されており、 NULL に設定する必要があります。

戻り値

EngHangNotification は、次のいずれかの値を返します。

リターン コード 説明
EHN_ERROR
 デバイスがエラーから回復しませんでした。
EHN_RESTORED
 デバイスが作業指示に復元されました。

注釈

ドライバーは、ハードウェアが動作不能または応答不能であることを検出するたびに、この呼び出しを行う必要があります。 EngHangNotification から EHN_RESTOREDが返された場合、ドライバーは操作不能状態を検出した操作を再試行する必要があります。それ以外の場合、ドライバーはできるだけ早く現在の呼び出しに失敗する必要があります。 問題を検出する後続のドライバー操作は、 EngHangNotification を再度呼び出す必要があります。

要件

要件 値
サポートされている最小のクライアント この関数は、Windows XP 以降で使用できます。
対象プラットフォーム ユニバーサル
Header winddi.h (Winddi.h を含む)
Library Win32k.lib
[DLL] Win32k.sys

こちらもご覧ください

DrvCompletePDEV

DrvResetDevice