RECORDER_LOG_CREATE_PARAMS结构 (wpprecorder.h)
RECORDER_LOG_CREATE_PARAMS 结构是 WppRecorderLogCreate 方法的输入参数。
语法
typedef struct _RECORDER_LOG_CREATE_PARAMS {
ULONG Size;
ULONG LogTag;
ULONG TotalBufferSize;
ULONG ErrorPartitionSize;
ULONG_PTR LogIdentifierAppendValue;
BOOLEAN LogIdentifierAppendValueSet;
ULONG LogIdentifierSize;
CHAR LogIdentifier[RECORDER_LOG_IDENTIFIER_MAX_CHARS];
WPP_RECORDER_TRI_STATE UseTimeStamp;
WPP_RECORDER_TRI_STATE PreciseTimeStamp;
} RECORDER_LOG_CREATE_PARAMS, *PRECORDER_LOG_CREATE_PARAMS;
成员
Size
此结构的大小。
LogTag
与日志的已分配内存关联的可选标记。
TotalBufferSize
日志区域的大小(以字节为单位)。
ErrorPartitionSize
TotalBufferSize 中用于记录错误消息的字节数。 零表示没有错误分区。
LogIdentifierAppendValue
要追加到日志标识符的数字/指针。
LogIdentifierAppendValueSet
指定是否已设置 LogIdentifierAppendValue 。
LogIdentifierSize
LogIdentifier 字段的大小,以字节为单位, (根据客户端的定义) 。
LogIdentifier[RECORDER_LOG_IDENTIFIER_MAX_CHARS]
合并调试消息时要打印的标识符。 驻留在结构末尾,这样,如果客户端在某个时候对数组大小有不同的定义,则读取结构的其余部分仍然很简单。
UseTimeStamp
一个WPP_RECORDER_TRI_STATE类型的值,指示:
- 如果设置为 WppRecorderTrue,则会将毫秒粒度的时间戳添加到 WPP 日志条目。
- 如果设置为 WppRecorderFalse,则不会记录时间戳。
- 如果设置为 WppRecorderDefault,则其效果与 WppRecorderFalse 相同,除非驱动程序包的 INF 文件将 WppRecorder_UseTimeStamp 设置为 1,在这种情况下,它表示 WppRecorderTrue。
此字段从 Windows 11 版本 22H2 开始可用。 有关详细信息,请参阅 用于记录跟踪的 inflight Trace Recorder (IFR) 。
PreciseTimeStamp
一个WPP_RECORDER_TRI_STATE类型的值,指示:
- 如果设置为 WppRecorderTrue,则会将十分之一微秒粒度的时间戳添加到 WPP 日志条目。
- 如果设置为 WppRecorderFalse,则不会记录时间戳。
- 如果设置为 WppRecorderDefault,则其效果与 WppRecorderFalse 相同,除非驱动程序包的 INF 文件将 WppRecorder_UseTimeStamp 和 WppRecorder_PreciseTimeStamp 设置为 1,在这种情况下,它表示 WppRecorderTrue。
此字段从 Windows 11 版本 22H2 开始可用。 有关详细信息,请参阅 用于记录跟踪的 inflight Trace Recorder (IFR) 。
要求
要求 | 值 |
---|---|
Header | wpprecorder.h |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈