Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 |
|---|---|
|
The device did not recover from the error. |
|
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 |