DrvResetDevice function

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

Target platform

Desktop

Header

Winddi.h (include Winddi.h)

See also

DrvEnablePDEV
EngHangNotification

 

 

Send comments about this topic to Microsoft

Show: