IddCxReportCriticalError 函数 (iddcx.h)
IddCxReportCriticalError 是由间接显示驱动程序(IDD)调用的 OS 回调函数,用于报告严重错误。
语法
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 检查代码检查驱动程序:
(pInArgs->MajorErrorCode+0x100 << 8) + pInArgs->MinorErrorCode
。 建议驱动程序使用主代码和次要代码的唯一组合,以便在崩溃和 Watson 报告中识别这些情况。 - 根据 UMDF 驱动程序重启策略终止驱动程序进程并重启。
- 如果调用方是远程 IDD,请断开用户会话的连接。
生成用户模式内存转储时,驱动程序应将任何有用的调试信息放在调用 IddCxCriticalError的函数堆栈上。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 10 |
标头 | iddcx.h |