附录(附录)

Windows Pen 验证指南的附录提供了有关手动运行 Windows 硬件实验室工具包 (HLK) 测试的信息、在最新内容发布后需要注意的一些要点以及一些常见问题的解答。

手动运行

根据测试情况,可能需要手动运行测试。 这也称为从命令行“独立”运行测试,而不是通过 HLK Studio 运行测试。 无法提交手动运行的测试进行兼容性认证。 因此,仅当遇到妨碍通过 HLK Studio 运行测试的问题,或者 Pen HLK 团队指示你这样做时,才应手动运行测试。

如果需要联系 Pen HLK 团队,可以通过向 pen_qn@microsoft.com 发送电子邮件来联系他们。

运行输入 HLK 测试之前

独立运行测试之前,请确保在受测设备上安装了正常 HLK 客户端,并且已获取仍为最新状态的开发人员许可证。 安装 HLK 客户端会确保设备上安装了测试所需的所有先决条件。 安装 HLK 客户端并获取开发人员许可证后,应该能够独立运行所有输入 HLK 测试。

运行测试所需的文件

可以在以下位置中找到笔测试文件:

  • 在 x86 系统上:

    C:\Program Files (x86)\Windows Kits\10\Hardware Lab Kit\Tests\x86\input\Digitizer

  • 在 amd64 系统上:

    C:\Program Files (x86)\Windows Kits\10\Hardware Lab Kit\Tests\amd64\input\Digitizer

请确保笔测试文件夹包含 TAEF 测试框架所需的文件,以及特定于笔的测试的文件。 下面是通常处于笔测试文件夹中的文件的列表:

  • 核心笔测试
    • PenTests.dll
    • PTS.dll
    • Pen.xml
    • PenLatencyTests.wsc
    • PenStaticTests.wsc
  • 笔测试工具
    • audiotouch.exe
    • stepmotor.exe
  • 测试工具文件
    • TAEF 文件夹
  • 支持文件
    • wlklogannotation.dll
    • WTTlog.dll

运行 PenTests 中的所有测试

使用以下命令可运行 PenTests 中包含的所有测试:

taef\\te.exe PenTests.dll

运行 PenTests 中的特定测试

若要运行特定测试,请使用 /name 参数,并使用 pen.xml 中提供的表 ID:

taef\\te.exe PenTests.dll /name:\*ContactAccuracy

使用 RA 工具运行延迟测试

  • 运行使用 RA 工具的所有测试

    使用以下命令可运行 RA 工具测试 (audiotouch/stepmotor) 中包含的所有测试:

    taef\\te.exe PenLatencyTests.wsc
    
  • 运行使用 RA 工具的特定测试

    若要运行特定测试,请使用 /name 参数。 例如:

    taef\\te.exe PenLatencyTests.wsc /name:\*audiotouch
    taef\\te.exe PenLatencyTests.wsc /name:\*stepmotor
    

    为第三方驱动程序运行测试(静态测试)

以下命令行将为第三方驱动程序运行静态测试:

taef\\te.exe PenStaticTests.wsc

下面是运行静态测试的结果的屏幕截图:

screenshot showing the result of running the static test for third party drivers.

发行说明

开始运行 PenTests 的初始步骤

首次运行 PenTests.dll 时,可能需要切换到全屏模式。 请按照屏幕上的步骤切换到全屏模式。 下面是有关切换的说明的屏幕截图:

screenshot of instructions for switching to full screen mode.

对于某些设备,全屏模式可能无法正常运行

对于某些设备,全屏窗口可能不会覆盖整个屏幕,测试背景画布可能显示为拉伸。 可以通过将缩放比例设置为 100% 来解决此问题。

常见问题解答

  • 合作伙伴如何提交有关 Pen HLK 和测试过程的问题?

    有关 Pen HLK 测试和验证过程的任何问题都可以定向到“Windows 10 笔提问”别名 (pen_qn@microsoft.com)。

  • 对于在不同平台上工作的笔设备,是否需要重复笔 HLK 测试,并针对使用笔的每个系统重新提交?

    是的,我们的 HLK 认证过程是对集成系统进行的。 我们不认证独立笔设备。

  • HLK 是否可以测试被动式触笔或其他类型的笔?

    只有符合主动式笔实现指南的主动式笔设备才能完成 HLK 测试。

  • 我有一台运行 Windows 10 移动版的设备。 是否仍可以使用 HLK 进行兼容性测试?

    目前未提供适用于运行 Windows 10 移动版的设备的 HLK 测试。 在提供此类测试之前,我们会依靠硬件合作伙伴来证明其设备满足 Windows 10 要求。

  • 我的设备屏幕对角线大小小于 4.5 英寸或大于 30 英寸。 是否仍可以使用 HLK 进行兼容性测试?

    遗憾的是,辅助测试 jig 和某些 HLK 测试仅支持屏幕大小为 4.5 英寸 - 30 英寸的设备。 如果设备不满足这些大小要求,请直接与我们联系,我们将与你合作设置测试过程,以便你可以获得兼容性认证。