EngHangNotification function

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

Syntax


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 codeDescription
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

Target platform

Universal

Version

This function is available in Windows XP and later.

Header

Winddi.h (include Winddi.h)

Library

Win32k.lib

DLL

Win32k.sys

See also

DrvCompletePDEV
DrvResetDevice

 

 

Send comments about this topic to Microsoft

Show: