Edit

Share via

DrvResetDevice function (winddi.h)

  • Article

The DrvResetDevice function resets a device that is inoperable or unresponsive.

Syntax

ULONG DrvResetDevice(
  DHPDEV dhpdev,
  PVOID  Reserved
);

Parameters

dhpdev

Handle to the physical device's PDEV that describes the physical device that has stopped. This is the value returned by DrvEnablePDEV.

Reserved

Is reserved and must be set to NULL.

Return value

DrvResetDevice should return one of the following values:

Return code Description
DRD_ERROR
 The device did not recover from the error.
DRD_SUCCESS
 The device is currently in working order.

Remarks

This function is available in Windows XP and later.

DrvResetDevice is usually called in response to EngHangNotification. A driver should take any steps necessary to restore the device to working order, and should do so with no data loss or as little as possible.

Requirements

Requirement Value
Target Platform Desktop
Header winddi.h (include Winddi.h)

See also

DrvEnablePDEV

EngHangNotification