Edit

Share via

EngHangNotification function (winddi.h)

  • Article

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

See also

DrvCompletePDEV

DrvResetDevice