WDF内核驱动开发------使用VHDL傻瓜式搭建HLK测试环境

踩坑后，得出的经验，整理成流程如下：

HLK测试环境有两种部署方案：

1.已加入域的环境。 在已加入域的环境中有一个域控制器，为 Windows HLK 功能指定的所有计算机将加入到同一个域控制器。 如果你计划在加入域的环境中部署 Windows HLK，则至少需要三台计算机：一台 Windows 域控制器、一台 Windows HLK 测试服务器和至少一个 Windows HLK 测试系统。 确保在域控制器上已配置并运行 Microsoft Active Directory。 域控制器和 HLK 测试服务器不能在同一个机箱中。

2.工作组环境。 工作组环境没有域控制器。 如果你计划在工作组中部署 Windows HLK，则至少需要两台计算机：一台测试服务器和一个加入同一工作组的测试系统。 请勿 使用默认管理员帐户。 在此配置中，必须启用来宾帐户。

这里选择工作组环境部署方案，需要两台计算机，一台计算机用作服务器，一台用作测试系统。

搭建步骤：

①搭建服务器环境。准备一台物理计算机，创建VHDL虚拟机。直接去官网下载VHDL，VHDL的版本应与测试系统的windos版本一致，windows版本可在“设置”--->“系统”—>右侧“关于”处查看。VHDL的下载地址为：Windows Hardware Lab Kit | Microsoft Learn。

下载好VHDL后，使用hyper-v管理器创建VHDL虚拟机，如何启用hyper-v，参阅微软官网：在 Windows 10 上启用 Hyper-V | Microsoft Learn。启用hypeer-v后，直接用hyper-v管理器串讲VHDL虚拟机，虚拟机的网络适配器选择桥接模式，如果网络适配器中没有桥接选项，则需要创建新的虚拟交换机，具体步骤见博文：Hyper-V设置桥接网络_hyper-v 网络桥接-优快云博客

②安装好VHDL后，根据官网步骤如下：（步骤中的VM即为安装好的VHDL）

1. 启动 VM
2. Windows 将启动并自动创建一个名为 HLKAdminUser 的管理员用户，密码为“Testpassword,1”。 登录。 注意：从适用于 Windows Server 2022 的 Windows HLK 及更高版本开始，系统第一次启动时会提示用户更改 HLKAdminUser 密码。 这里的问题是：以前的密码为空白（未创建），因此，如果输入提到的密码（“以前的密码”），将显示有关以前的密码不正确的消息。 清除“以前的密码”框并设置新密码即可继续。
3. 然后，VM 将在首次启动时运行某些 HLK 设置
   • 请等待所有 cmd 窗口完成，然后再使用 HLK
   • 注意：在此之前，有时屏幕会全部为黑色。 VM 仍在运行，如果 VM 未使用推荐的设置，则有时会需要一些时间来加载桌面。
   • 请勿重命名该 VM。 如果更改计算机名称，则将无法连接到 HLK 控制器。
4. 所有 cmd 窗口完成后，您可能希望更改日期/时间设置。
   • 默认情况下，服务器设置为“(UTC) 协调世界时”，并关闭“自动设置时区”和“自动调整夏令时”。 尝试对齐各种客户端/控制器日志的时间戳时，这可能会导致混淆。 要更改：
     1. 单击任务栏的日期/时间部分
     2. 从浮出控件底部选择“日期和时间设置”
     3. 从下拉列表中指定所在的时区
     4. 打开“自动调整夏令时”（如果需要）
   • 现在，时间应与各种客户端设备和主机进行同步。
5. 此时已完成操作，并且 VHLK 已准备就绪，可供使用。

配置网络设置

在所有系统上，必须启用网络发现和文件共享。 有时，域加入系统将默认这些设置为“关闭”。

1. 控制面板（图标视图）->网络和共享中心
2. 转到“更改高级共享设置”
3. 在当前配置文件中，设置“启用网络发现”和“打开文件和打印机共享”
4. 在主机系统、虚拟机和所有桌面客户端系统上验证这些设置。 更改任何网络之后验证这些设置

③查看服务器和测试系统是否处于一个工作组中："系统"---“高级系统设置”----“计算机名”，计算机名下有计算机名称及工作组信息等。关闭测试系统防火墙，查看测试系统与服务器能否相互ping通，如果能够相互ping通，则进行测试系统的客户端安装操作。

④在测试系统中，先安装好待测试的驱动之后。cmd以管理员的方式打开。执行命令

\\<ControllerName>\HLKInstall\Client\Setup.cmd。
（将 <ControllerName> 替换为测试服务器的名称，即为③中在服务器下看到的计算机名称）

如果执行命令后遇到：用户名和密码不正确的情况，则需要在服务器的网络和共享服务高级设置中选择“Turn off password protected shaging”

客户端安装过程：

1. 如果尚未安装以下软件，则在此步骤中安装该软件（自动安装）：

   • .NET Framework 4（客户资料和扩展）
   • 应用程序验证工具
   • Windows 驱动程序测试框架 (WDTF)
   • Windows 性能工具包 (WPT)。

2. 此时将显示“Windows Hardware Lab Kit 客户端安装向导”。 要启动向导，请选择“下一步”。

3. 在“Internet 连接防火墙协议”页上，选择“是，我将允许打开端口”，然后选择“下一步”。

    备注

     如果未显示“Internet 连接防火墙协议”页，则表示未安装 Windows 防火墙，或者计算机上安装了其他软件防火墙或硬件防火墙。 如果安装了其他防火墙，则必须手动打开 TCP 端口 1771 才能继续安装。 请参阅防火墙产品提供的说明，手动打开 TCP 端口。 如果在未打开端口 1771 的情况下继续操作，安装可能会失败，或者客户端软件可能无法正常工作。

4. 当出现“准备安装”页时，选择“安装”。

5. 单击 “完成” 退出向导。

 至此，hlk测试环境已搭建完毕，创建测试项目等，可以参照微软官网：

第 3 步：创建计算机池 (step-3-create-a-machine-pool) | Microsoft Learn