Share via


DrvResetDevice-Funktion (winddi.h)

Die DrvResetDevice-Funktion setzt ein Gerät zurück, das nicht funktionsfähig ist oder nicht reagiert.

Syntax

ULONG DrvResetDevice(
  DHPDEV dhpdev,
  PVOID  Reserved
);

Parameter

dhpdev

Handle mit dem PDEV des physischen Geräts, das das angehaltene physische Gerät beschreibt. Dies ist der von DrvEnablePDEV zurückgegebene Wert.

Reserved

Ist reserviert und muss auf NULL festgelegt werden.

Rückgabewert

DrvResetDevice sollte einen der folgenden Werte zurückgeben:

Rückgabecode Beschreibung
DRD_ERROR
Das Gerät wurde nach dem Fehler nicht wiederhergestellt.
DRD_SUCCESS
Das Gerät funktioniert derzeit.

Hinweise

Diese Funktion ist in Windows XP und höher verfügbar.

DrvResetDevice wird normalerweise als Reaktion auf EngHangNotification aufgerufen. Ein Treiber sollte alle erforderlichen Schritte unternehmen, um das Gerät wieder funktionsfähig zu machen, und dies ohne Datenverlust oder so wenig wie möglich tun.

Anforderungen

   
Zielplattform Desktop
Kopfzeile winddi.h (einschließlich Winddi.h)

Weitere Informationen

DrvEnablePDEV

EngHangNotification