Fonction EngHangNotification (winddi.h)
La fonction EngHangNotification avertit le système qu’un appareil spécifié est inopérable ou ne répond pas.
Syntaxe
ENGAPI ULONG EngHangNotification(
HDEV hdev,
PVOID Reserved
);
Paramètres
hdev
Gérez l’appareil physique qui s’est arrêté. Ce paramètre est le handle GDI reçu par le point d’entrée DrvCompletePDEV du pilote.
Reserved
Est réservé et doit être défini sur NULL.
Valeur retournée
EngHangNotification retourne l’une des valeurs suivantes :
Code de retour | Description |
---|---|
|
L’appareil n’a pas récupéré de l’erreur. |
|
L’appareil a été restauré en état de fonctionnement. |
Remarques
Un pilote doit effectuer cet appel chaque fois qu’il détecte que le matériel est inutilisable ou ne répond pas. Si EngHangNotification retourne EHN_RESTORED, le pilote doit réessayer l’opération qui a détecté l’état inopérable ; sinon, le pilote doit échouer l’appel actuel dès que possible. Toutes les opérations de pilote suivantes qui détectent un problème doivent à nouveau appeler EngHangNotification.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Cette fonction est disponible dans Windows XP et versions ultérieures. |
Plateforme cible | Universal |
En-tête | winddi.h (inclure Winddi.h) |
Bibliothèque | Win32k.lib |
DLL | Win32k.sys |