EngHangNotification function (winddi.h)

Article
10/05/2021

The EngHangNotification function notifies the system that a specified device is inoperable or unresponsive.

Syntax

ENGAPI ULONG EngHangNotification(
  HDEV  hdev,
  PVOID Reserved
);

Parameters

hdev

Handle to the physical device that has stopped. This parameter is the GDI handle received by the driver's DrvCompletePDEV entry point.

Reserved

Is reserved and must be set to NULL.

Return value

EngHangNotification returns one of the following values:

Return code	Description
EHN_ERROR	The device did not recover from the error.
EHN_RESTORED	The device was restored to working order.

Remarks

A driver should make this call any time it detects that the hardware is inoperable or unresponsive. If EngHangNotification returns EHN_RESTORED, the driver should retry the operation that detected the inoperable state; otherwise the driver should fail the current call as soon as possible. Any subsequent driver operations that detect a problem should again call EngHangNotification.

Requirements

Requirement	Value
Minimum supported client	This function is available in Windows XP and later.
Target Platform	Universal
Header	winddi.h (include Winddi.h)
Library	Win32k.lib
DLL	Win32k.sys