TestInfo 结构

包含测试句柄的元数据。

语法

struct TestInfo
{
    GUID testId;
    unsigned int dataSequenceId;
    unsigned int flags;
    PSTR data;
    LONGLONG startPerformanceCounter;
    unsigned int observedSleepTimeInMs;
    unsigned int properties;
};

成员

testId

测试实例标识符。

dataSequenceId

测试数据的版本。

flags

测试数据的标志。 这可以设置为以下值的组合。

值	说明
0	默认标志。
256	测试已标记为完成。
512	测试已显式完成。
1024	Test 与多个调用方发生争用，其选项值为 1 时调用 TestUnlockData 。
65536	未能获取跨进程锁。
131072	无法等待跨进程锁。
262144	无法读取或写入永久性存储。
524288	无法分析持久化的数据。
1048576	分配内存失败。
2097152	指示 metricsBucket 和 testCaseIdStart 将包含在 TipReportingInfo 中。
4194304	指示已使用值 2 调用 TestControlReporting 。

数据

任意 JSON 字符串。

startPerformanceCounter

测试开始的计数器。

observedSleepTimeInMs

处于睡眠或暂停状态的时间量。

properties

测试属性。 仅当在调用 TestCreate 或 TestOpen 中指定了 131072 的选项值时，此值才存在。 此字段可以设置为以下值的组合。

值	说明
0	默认属性。
1	不存在测试句柄时，不会从存储中删除测试数据。
2	将关键字 (keyword) 位 45 添加到每个进程的失败 ETW 事件一次。
4	将关键字 (keyword) 位 46 添加到每个失败 ETW 事件。
8	将关键字 (keyword) 位 45 添加到成功 ETW 事件。
16	将关键字 (keyword) 位 46 添加到每个成功的 ETW 事件。
32	将测试过期时间设置为 24 小时。
64	将测试过期时间设置为 7 天。
128	将关键字 (keyword) 位 45 添加到失败 ETW 事件。
256	将关键字 (keyword) 位 45 添加到每个进程一次的成功 ETW 事件。
512	将 ETW 事件属性 metricsBucket 限制为 8 位。
2048	在 ETW 事件中包括关键字 (keyword) 位 3。
4096	在 ETW 事件中包括关键字 (keyword) 位 2。
8192	在 ETW 事件中包括关键字 (keyword) 位 4。

要求

要求	值
最低受支持的客户端	Windows 内部版本 22000
最低受支持的服务器	Windows Server 2022
标头	无