PWRTest 命令行工具使用指南

以下是对 PWRTest.exe 命令行工具的使用说明。PWRTest.exe 是一个用于测试和监控系统电源管理相关功能的工具。

命令行的格式是：pwrtest /scenario [/scenario_options] [/common_options]。

其中，/scenario 参数用于指定要执行的测试场景，可选的测试场景包括：

• 'sleep'：运行睡眠/唤醒过渡测试。
• 'battery'：获取电池信息并进行监控。
• 'info'：获取系统电源信息。
• 'es'：监控线程的执行状态。
• 'idle'：监控系统的空闲状态。
• 'ppm'：监控处理器的功耗管理。
• 'timer'：监控系统的定时器分辨率。
• 'disk'：监控磁盘的空闲状态。
• 'device'：监控设备的空闲状态。
• 'monitor'：监控显示器的亮度/黑屏状态（用户空闲时）。
• 'requests'：监控电源请求。
• 'thermal'：监控 ACPI 热区。
• 'processidle'：监控并强制运行空闲/后台任务。
• 'cs'：运行连接待机过渡测试。
• 'platidle'：监控平台的空闲统计信息。

/scenario_options 参数用于显示指定测试场景的可选参数，例如：pwrtest.exe /sleep /?。

/common_options 参数用于指定一些通用选项，包括：

• /lf:folder：指定日志文件存放的文件夹路径，默认为与 pwrtest.exe 相同的文件夹。
• /ln:name：指定日志文件和 ETW 跟踪会话的名称，默认为 pwrtestlog。
• /etwbuffersize:n：指定 ETW 缓冲区的大小（以 KB 为单位），默认为当前页面大小或 256KB（取较大者）。
• /etwminbuffers:n：指定为 ETW 会话分配的最小缓冲区数量，默认为每个逻辑处理器 2 个缓冲区。
• /etwmaxbuffers:n：指定为 ETW 会话分配的最大缓冲区数量，默认为 etwminbuffers + 20。
• /delaywrite：当指定此选项时，日志数据将在内存中缓冲以减少磁盘写入。对所有类型的日志都有效，包括 ETL。

执行要求：

• 必须以管理员权限/提升的命令提示符中运行，以支持 ETW 跟踪。
• 必须以本地方式运行（不支持 WoW64），以支持 ETW 跟踪。
• 系统管理员设置的组策略可能会干扰某些需要临时修改电源设置值的场景（如睡眠场景）。