写入信息日志条目

以下示例演示应用程序通常如何调用 SetupWriteTextLog 以在 SetupAPI 文本日志 中写入不是警告消息或错误消息的信息条目。

有关调用 SetupWriteTextLog 以记录错误消息的信息，请参阅 调用 SetupWriteTextLog 以记录错误或警告条目。

应用程序调用 SetupWriteTextLog，并提供以下参数值：

• LogToken 设置为通过调用 SetupGetThreadLogToken 获取的日志令牌值，或者是 日志令牌中描述的系统定义的日志令牌值之一。

• 类别 设置为 TXTLOG_VENDOR，表示日志条目由供应商提供的应用程序创建。 为文本日志启用事件类别中介绍了事件类别。

• 标志 设置为TXTLOG_DETAILS和TXTLOG_TIMESTAMP的按位 OR。 在此示例中，缩进深度未更改，并且当前缩进深度以前设置为五个单空间文本空间。 有关如何更改缩进深度的信息，请参阅 编写缩进日志条目。 设置文本日志的事件级别主题中介绍了事件级别。

• MessageStr 设置为 TEXT (“感兴趣的变量： = %d”) 。

• 逗号分隔的参数列表提供变量 SomeVariable，该变量对应于 MessageStr 中的“%d”字段。

//The LogToken value was previously returned by call to
//SetupGetThreadLogToken or one of the system-defined log token values
DWORD Category = TXTLOG_VENDOR; 
DWORD Flags = TXTLOG_DETAILS | TXTLOG_TIMESTAMP;
DWORD SomeVariable = 1;   // The variable whose value will be logged

SetupWriteTextLog(LogToken, Category, Flags, TEXT("Variable of interest: = %d"), SomeVariable);

如果启用了TXTLOG_VENDOR事件类别并为设备安装文本日志设置了TXTLOG_DETAILS事件级别，则此代码将在设备安装日志中创建以下格式的条目，其中时间戳将替换为实际时间戳。

     2005/02/13 22:06:28.109:    :  Variable of interest: Abc = 1