Partager via


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
EHN_ERROR
L’appareil n’a pas récupéré de l’erreur.
EHN_RESTORED
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

Voir aussi

DrvCompletePDEV

DrvResetDevice