EngHangNotification-Funktion (winddi.h)

Artikel
03/13/2024

Die EngHangNotification-Funktion benachrichtigt das System, dass ein angegebenes Gerät nicht funktionsfähig ist oder nicht reagiert.

Syntax

ENGAPI ULONG EngHangNotification(
  HDEV  hdev,
  PVOID Reserved
);

Parameter

hdev

Handle für das physische Gerät, das beendet wurde. Dieser Parameter ist das GDI-Handle, das vom DrvCompletePDEV-Einstiegspunkt des Treibers empfangen wird.

Reserved

Ist reserviert und muss auf NULL festgelegt werden.

Rückgabewert

EngHangNotification gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
EHN_ERROR	Das Gerät wurde nach dem Fehler nicht wiederhergestellt.
EHN_RESTORED	Das Gerät wurde in der funktionierenden Reihenfolge wiederhergestellt.

Hinweise

Ein Treiber sollte diesen Aufruf jedes Mal ausführen, wenn er erkennt, dass die Hardware nicht funktionsfähig ist oder nicht reagiert. Wenn EngHangNotification EHN_RESTORED zurückgibt, sollte der Treiber den Vorgang wiederholen, der den inoperablen Zustand erkannt hat. Andernfalls sollte der Treiber den aktuellen Aufruf so schnell wie möglich fehlschlagen. Alle nachfolgenden Treibervorgänge, die ein Problem erkennen, sollten erneut EngHangNotification aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Diese Funktion ist in Windows XP und höher verfügbar.
Zielplattform	Universell
Header	winddi.h (einschließlich Winddi.h)
Bibliothek	Win32k.lib
DLL	Win32k.sys

Weitere Informationen

DrvCompletePDEV

DrvResetDevice

Share via