通过

EngHangNotification 函数 (winddi.h)

  • 项目

EngHangNotification 函数通知系统指定的设备无法操作或无响应。

语法

ENGAPI ULONG EngHangNotification(
  HDEV  hdev,
  PVOID Reserved
);

参数

hdev

已停止的物理设备的句柄。 此参数是驱动程序的 DrvCompletePDEV 入口点接收的 GDI 句柄。

Reserved

为保留，必须设置为 NULL。

返回值

EngHangNotification 返回以下值之一：

返回代码 说明
EHN_ERROR
 设备无法从错误中恢复。
EHN_RESTORED
 设备已还原到工作顺序。

注解

驱动程序应在检测到硬件无法操作或无响应时发出此调用。 如果 EngHangNotification 返回EHN_RESTORED，则驱动程序应重试检测到不可操作状态的操作;否则，驱动程序应尽快使当前调用失败。 检测到问题的任何后续驱动程序操作都应再次调用 EngHangNotification。

要求

要求 值
最低受支持的客户端 此函数在 Windows XP 及更高版本中可用。
目标平台 通用
标头 winddi.h (包括 Winddi.h)
Library Win32k.lib
DLL Win32k.sys

另请参阅

DrvCompletePDEV

DrvResetDevice