PwrTest 语法

从命令提示符窗口运行 PwrTest。 可以使用命令选项选择和配置 PwrTest 方案

PwrTest 工具的语法为:

pwrtest /scenario [/scenario_options] [/common_options]

/scenario

方案 说明
sleep 通过睡眠/恢复转换来循环计算机。 (Windows 7 及更高版本)
电池 提供电池信息和监视。 (Windows 7 及更高版本)
info 提供系统电源信息。 (Windows 7 及更高版本)
es 监视线程执行状态。 (Windows 7 及更高版本)
监视系统空闲事件。 (Windows 7 及更高版本)
ppm 监视处理器电源管理。 (Windows 7 及更高版本)
计时器 监视系统计时器解析更改。 (Windows 7 及更高版本)
disk 监视磁盘空闲统计信息和自旋事件。 (Windows 7 及更高版本)
device 监视设备空闲统计信息和关闭事件。 (Windows 7 及更高版本)
monitor 记录与监视/显示自动变暗和空白相关的用户空闲统计信息。(Windows 7 及更高版本)
请求 显示未完成的电源请求和新电源请求。 (Windows 7 及更高版本)
监视 ACPI 热区域信息和统计信息。 这仅在报告热区域和温度变化的系统上受支持。 (Windows 7 及更高版本)。
processidle 强制执行后台维护任务(现在而不是按计划时间执行),并监视其进度。 (Windows 7 及更高版本)
cs 如果系统支持连接待机转换,则通过连接待机转换来循环计算机。 (Windows 8 及更高版本)
platidle 监视和尝试记录平台空闲转换计数(如果系统支持)。 (Windows 8 及更高版本)
directedfx 监视与 定向电源管理框架(DFx)相关的低功率空闲状态开关。 (Windows 10 版本 1903 及更高版本)

/scenario_options
若要查看每个 Pwrtest 方案可用的选项,请键入: pwrtest.exe /scenario /?

例如: pwrtest.exe /sleep /?

/common_options

common_options 说明
/lf:folder 指定日志文件的文件夹。 例如,c:\myfolder 或 \\server\share。 默认日志位置与pwrtest.exe文件夹相同。
/ln:name 指定日志文件的名称以及 Windows 事件跟踪(ETW)跟踪会话的名称。 会自动添加日志文件扩展名(.wtl、.xml等)。 默认名称为 pwrtestlog。
/etwbuffersize:n 如果 ETW 缓冲区大小大于默认大小,则指定 KB 中的 ETW 缓冲区大小。 默认值为当前页大小或 256KB(以更大者为准)。
/etwminbuffers:n 指定分配给 ETW 会话的最小缓冲区数(如果大于每个逻辑处理器的最小 2 个)。 默认值为每个逻辑处理器 2 个缓冲区。
/etwmaxbuffers:n 指定为 ETW 会话分配的最大缓冲区数(如果该数字大于每个逻辑处理器的最小值 2),并且大于 etwminbuffers 设置。 默认值为 etwminbuffers 值 + 20。
/delaywrite 指定日志数据在内存中缓冲,以减少磁盘写入。 此选项会影响包括 ETL 在内的所有日志类型。

示例

pwrtest /?  
pwrtest /requests  /?
pwrtest /requests  /t:60

备注

支持 ETW 跟踪的执行要求:

  • Pwrtest 必须从管理员或提升的 命令提示符 窗口运行(以管理员身份运行)。

  • Pwrtest 必须以本机方式运行(不支持 WoW64)。

系统管理员实施的组策略设置可能会干扰某些需要暂时修改电源设置值(如睡眠方案)的方案。

PwrTest 在.log(纯文本)、.xml(格式因方案而异)、.wtl(WTTLog)和 .etl(ETW 跟踪)日志格式中的每个执行自动生成多个日志。

若要能够使用所有 PwrTest 方案,必须先预配测试计算机以使用 Visual Studio 和 WDK 进行测试。 有关详细信息,请参阅预配计算机进行驱动程序部署和测试(WDK 8.1),为驱动程序部署和测试预配计算机(WDK 8)。 某些方案需要属于 Windows 驱动程序测试框架(WDTF)的电源按钮驱动程序。 预配系统以使用 Visual Studio 和 WDK 进行测试时,将自动安装 WDTF(和包含的电源按钮驱动程序)。 有关 WDTF 的信息,请参阅 Windows 设备测试框架 (WDTF) (Windows 驱动程序)。

PwrTest 方案

PwrTest 日志文件