EngHangNotification-Funktion (winddi.h)
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 |
|---|---|
|
Das Gerät wurde nach dem Fehler nicht wiederhergestellt. |
|
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 |