Funzione EngHangNotification (winddi.h)
La funzione EngHangNotification notifica al sistema che un dispositivo specificato è inoperabile o non risponde.
Sintassi
ENGAPI ULONG EngHangNotification(
HDEV hdev,
PVOID Reserved
);
Parametri
hdev
Gestire il dispositivo fisico arrestato. Questo parametro è l'handle GDI ricevuto dal punto di ingresso DrvCompletePDEV del driver.
Reserved
È riservato e deve essere impostato su NULL.
Valore restituito
EngHangNotification restituisce uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Il dispositivo non è stato ripristinato dall'errore. |
|
Il dispositivo è stato ripristinato in base all'ordine di lavoro. |
Commenti
Un driver deve effettuare questa chiamata ogni volta che rileva che l'hardware è inoperabile o non risponde. Se EngHangNotification restituisce EHN_RESTORED, il driver deve ripetere l'operazione che ha rilevato lo stato inoperabile; in caso contrario, il driver non deve eseguire la chiamata corrente il prima possibile. Tutte le operazioni successive del driver che rilevano un problema devono chiamare nuovamente EngHangNotification.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Questa funzione è disponibile in Windows XP e versioni successive. |
| Piattaforma di destinazione | Universale |
| Intestazione | winddi.h (include Winddi.h) |
| Libreria | Win32k.lib |
| DLL | Win32k.sys |