将通用 Windows 驱动程序添加到工厂 OS 映像

可以通过定义驱动程序功能清单文件,然后将驱动程序功能清单添加到 OEMInput.xml 中,来将通用 Windows 驱动程序添加到映像。 WSK 附带一组工具,用于简化此文件的初始创建后续修改

注意

为了加快驱动程序测试速度,可以将驱动程序直接添加到测试映像

先决条件

准备文件

  1. 在本地电脑上收集所有驱动程序文件,其中包括 .inf、驱动程序支持的所有体系结构(x64、x86 和 arm)的所有系统文件和服务。

  2. 将驱动程序保存到工作区。 建议在工作区中使用 DCHUDrivers 位置,例如 C:\Workspace\DCHUDrivers\。 可以使用子文件夹,这些脚本可以在其中找到你的驱动程序。

将驱动程序添加到工作区中包含的驱动程序 FM

工作区包含一个空的驱动程序 FM,它已包含在 OEMInput.xml 文件中。 若要将驱动程序添加到映像,请使用 WSK 中的脚本将驱动程序添加到驱动程序 FM。 如果不想使用此 FM,但想要了解如何创建新的驱动程序 FM 并让其包含在 OEMInput.xml 文件中,请参阅创建新的驱动程序 FM

将驱动程序添加到工作区的驱动程序 FM:

  1. 以管理员身份启动 Windows 系统工具包生成环境(例如,在装载的 WSK ISO 中,右键单击 E:\SetImagGenEnv.cmd,然后单击“以管理员身份运行”)。

  2. 在 Windows 系统工具包生成环境中,导航到工作区文件夹:

    cd c:\Workspace
    
  3. 将工作区根变量设置为指向“将 WSKWorkspaceRoot 环境变量更新为指向你的工作区”。

    C:\Workspace\SetWSKWorkspaceRoot.cmd
    
  4. 将工作区中的驱动程序添加到随附的驱动程序 FM:使用 WSK 中的脚本更新驱动程序 FM,以便它包含工作区中的驱动程序。

    运行 UpdateWSKDriversFM 脚本,将工作区 DCHU 文件夹 (%WSKWorkspaceRoot%\DHCUDrivers) 中的所有驱动程序添加到 OEMDriversFM.xml。 此 FM 中列出的所有驱动程序都将包含在映像中。

    UpdateWSKDriversFM
    

    如果未指定任何选项,该脚本将更新 %WSKWorkspaceRoot%\FMFiles\OEMDriversFM.xml 文件,使之包含工作区的 DCHUDrivers 文件夹中的所有驱动程序。 有关脚本选项,请参阅下面的 UpdateWSKDriversFM 语法

    默认情况下,驱动程序包含在所有映像设计中,但如果你使用一组集中的附件创建多个映像设计,则可以添加功能标识符

    添加、删除或更新驱动程序时,请重新运行 UpdateWSKDriversFM 以将更改添加到功能清单中。

创建新的驱动程序 FM

可以使用 Windows 系统工具包中的脚本来创建新的驱动程序 FM:

从 Windows 系统工具包环境中:

  1. 将要包含的驱动程序放在文件夹中。

  2. 运行 CreateWSKDriversFM 脚本以包含驱动程序文件夹中的所有驱动程序。 指定新 DriverFM 的名称和驱动程序文件夹:

    CreateWSKDriversFM -fmfile %WSKWorkspaceRoot%\FMFiles\NewOEMDriversFM.xml -InfFolder C:\NewDrivers
    

    有关脚本选项,请参阅下面的 CreateWSKDriversFM 语法

    例如,此脚本会创建一个新的功能清单文件,例如 %WSKWorkspaceRoot%\FMFiles\NewOEMDriversFM.xml,其中包含每个驱动程序的位置。

    默认情况下,驱动程序包含在所有映像设计中,但如果你使用一组集中的附件创建多个映像设计,则可以添加功能标识符,并选择要包含在映像中的驱动程序。

  3. 将新的驱动程序 FM 添加到 OEMInput.xml 文件,方法是将其作为 <AdditionalFM> 添加:

    <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\NewOEMDriversFM.xml</AdditionalFM>
    
  4. 如果添加、删除或更新驱动程序,请运行 UpdateWSKDriversFM 以将驱动程序添加到功能清单中。

    UpdateWSKDriversFM -fmfile %WSKWorkspaceRoot%\FMFiles\NewOEMDriversFM.xml -InfFolder C:\NewDrivers
    

驱动程序 FM 脚本语法

CreateWSKDriversFM 语法

CreateWSKDriversFM {-FMFile: [path]} {-InfFolder [Path]}
参数 说明
-FMFile [路径] 要创建的 FM 文件的路径。 默认情况下创建或替换 %WSKWorkspaceRoot%\FMFiles\OEMDriversFM.xml
-InfFolder [路径] 要在其中搜索驱动程序的文件夹的路径。 默认情况下搜索 %WSKWorkspaceRoot%\DCHUDrivers

UpdateWSKDriversFM 语法

UpdateWSKDriversFM {-FMFile: [path]} {-InfFolder [Path]}
参数 说明
-FMFile [路径] 要更新的 FM 文件的路径。 默认情况下创建或替换 %WSKWorkspaceRoot%\FMFiles\OEMDriversFM.xml
-InfFolder [路径] 要在其中搜索驱动程序的文件夹的路径。 默认情况下搜索 %WSKWorkspaceRoot%\DCHUDrivers