Função EngHangNotification (winddi.h)

  • Artigo

A função EngHangNotification notifica o sistema de que um dispositivo especificado está inoperável ou sem resposta.

Sintaxe

ENGAPI ULONG EngHangNotification(
  HDEV  hdev,
  PVOID Reserved
);

Parâmetros

hdev

Identificador para o dispositivo físico que parou. Esse parâmetro é o identificador GDI recebido pelo ponto de entrada DrvCompletePDEV do driver.

Reserved

É reservado e deve ser definido como NULL.

Retornar valor

EngHangNotification retorna um dos seguintes valores:

Código de retorno Descrição
EHN_ERROR
 O dispositivo não se recuperou do erro.
EHN_RESTORED
 O dispositivo foi restaurado para a ordem de funcionamento.

Comentários

Um driver deve fazer essa chamada sempre que detectar que o hardware está inoperável ou sem resposta. Se EngHangNotification retornar EHN_RESTORED, o driver deverá repetir a operação que detectou o estado inoperável; caso contrário, o driver deve falhar na chamada atual assim que possível. Todas as operações de driver subsequentes que detectam um problema devem chamar EngHangNotification novamente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Essa função está disponível no Windows XP e posterior.
Plataforma de Destino Universal
Cabeçalho winddi.h (inclua Winddi.h)
Biblioteca Win32k.lib
DLL Win32k.sys

Confira também

DrvCompletePDEV

DrvResetDevice