PwrTest 语法

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

PwrTest 工具的语法为:

pwrtest /scenario [/scenario_options] [/common_options]

/场景

方案 说明
sleep 使计算机通过睡眠/恢复转换周期。 (Windows 7 及更高版本)
电池 提供电池信息和监视。 (Windows 7 及更高版本)
info 提供系统电源信息。 (Windows 7 及更高版本)
es 监视线程执行状态。 (Windows 7 及更高版本)
空闲 监视系统空闲事件。 (Windows 7 及更高版本)
Ppm 监视处理器电源管理。 (Windows 7 及更高版本)
计时器 监视系统计时器分辨率更改。 (Windows 7 及更高版本)
disk 监视磁盘空闲统计信息和降速事件。 (Windows 7 及更高版本)
设备 监视设备空闲统计信息和关机事件。 (Windows 7 及更高版本)
监视 记录与监视器/显示自动变暗和空白相关的用户空闲统计信息。 (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 缓冲区大于默认大小,则指定 ETW 缓冲区大小(以 KB 为单位)。 默认值为当前页大小或 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 日志文件