日志记录清单概述

日志记录清单是一组“标头”文件,用于定义被截获和记录的函数和 COM 接口。 这些不是真正的 C++ 头文件 -- 它们的格式略有不同,用于显式声明 Logger 所需的信息。

例如,清单格式有助于实现以下功能:

  • 指定 OUT 参数。 这些参数在进入函数的方式和出路时都应记录这些参数。

  • 标志掩码的定义。 此功能允许 LogViewer 将 DWORD 标志分解为其构成位标签,以便于阅读。

  • 故障案例的定义。 此功能允许 LogViewer 对返回失败状态代码或其他错误代码的函数行进行着色。 此外,如果函数为线程设置“LastError”值,则 LogViewer 可以存储掉错误代码,并将其扩展为相应的人工可读错误消息。

  • 指定可用于对数差异进行别名的参数。 此功能使 LogViewer 能够选择将常量字符串分配给从执行更改为执行的值,例如指针,并在将数据导出到文件时进行处理。 然后,可以使用差异工具来比较两个执行日志的差异。 如果指针和句柄值没有别名,则比较这两个文件时,它们会产生无兴趣的差异。