IddCxReportCriticalError 函数 (iddcx.h)

  • 项目

IddCxReportCriticalError 是间接显示驱动程序调用的 OS 回调函数， (IDD) 报告严重错误。

语法

NTSTATUS IddCxReportCriticalError(
  IDDCX_ADAPTER                      AdapterObject,
  const IDARG_IN_REPORTCRITICALERROR *pInArgs
);

参数

AdapterObject

发生严重错误的适配器 的IDDCX_ADAPTER 对象。 如果错误发生在创建IDDCX_ADAPTER之前，IDD 应传递 nullptr。

pInArgs

指向包含严重错误的错误代码 的IDARG_IN_REPORTCRITICALERROR 结构的指针。

返回值

如果例程成功，它永远不会返回到驱动程序，因为驱动程序进程将终止。

注解

当 IDD 调用 IddCxCriticalError 时，OS 将执行以下操作：

  • 使用以下 bug 检查代码对驱动程序进行 Bug 检查： (pInArgs->MajorErrorCode+0x100 << 8) + pInArgs->MinorErrorCode。 建议驱动程序使用主代码和次要代码的唯一组合，以便在崩溃和 Watson 报告中识别这些情况。
  • 终止驱动程序进程，并根据 UMDF 驱动程序重启策略重新启动。
  • 如果调用方是远程 IDD，请断开用户会话的连接。

生成用户模式内存转储时，驱动程序应在调用 IddCxCriticalError 的函数堆栈上放置任何有用的调试信息。

要求

要求 值
最低受支持的客户端 Windows 10
标头 iddcx.h

另请参阅

IDARG_IN_REPORTCRITICALERROR