修补工厂 OS 映像以进行测试
为了加快测试速度,可以将驱动程序、自定义包和测试内容直接添加到测试映像中,从而无需在每次测试其中一种类型的包时都重新生成映像。
先决条件
- 一个测试映像,使用 OEMInput 文件中的
ReleaseType=Test
生成。 - 一个或更多:
- 通用 Windows 驱动程序,其 CPU 体系结构类型必须与目标测试映像匹配。
- 包含测试材料的测试内容文件夹
- 自定义包
使用情况
ImageApp.exe [OutputFile] /Patch [/Drivers:[List_of_INF_Files]] [/Customizations:[List_of_OEM_Customization_Cab]] [/TestContent:[Folder_Containing_Test_Collateral]] [/CPUType:x]
OutputFile:要修改的映像的路径。
/Patch:向 [OutputFile] 添加其他自定义项
/CPUType:x:要修改的映像的 CPU 体系结构类型。 值:{arm|arm64|x86|amd64}
此命令至少需要以下选项之一:
- /Drivers:[Folder_containing_driver_files]:驱动程序或包含驱动程序的目录的路径。 支持添加多个驱动程序文件和/或目录,以分号分隔。 尝试以递归方式安装内容。
- /Customizations:[Folder_containing_Customization_Cabs]:要添加到 [OutputFile] 的 OEM 自定义 cab 文件的以分号分隔的列表
- /TestContent:[Folder_containing_test_collateral]:位于用户数据分区中 TestContent 文件夹下的、包含要添加到映像的已签名测试附件的文件夹列表
示例:
ImageApp.exe image.ffu /Patch /Customizations:C:\workspace\Contoso_Customization\ /TestContent:c:\workspace\TestContent /CPUType:amd64
注意
无法对根文件夹中的映像运行此命令。 对不是根文件夹的清理文件夹中的映像运行此命令。
疑难解答
错误代码 0x800700ea
如果你在尝试向 FFU 映像添加驱动程序时看到错误代码 0x800700ea
,则可能还安装了一些 VHDX 文件。 在技术人员电脑上使用磁盘管理,尝试卸除与正在使用的映像相关的所有已装载 VHDX,然后重试。
显示错误 0x800700ea
的示例日志:
{2/24/2020 4:56:43 PM} Imaging: FFU file '\\?\C:\FFU\ImageApp\FactoryOS_Development_AMD64_UEFI_SpacesGPT_Hardware.ffu' loaded.
{2/24/2020 4:56:48 PM} Error: GetVolumeFromPartitionName: Waiting for DATA with store ID 0x0 failed with error code 0x800700ea.
{2/24/2020 4:56:48 PM} Error: [00:00:00] 'Failed call to GetPartitionPath for the ‘????’ partition': HRESULT_FROM_WIN32(234)
{2/24/2020 4:56:48 PM} Error: Imaging!UpdateImage: Failed to Initialize UpdateDLL::UpdateMain with error code: -2147024662 (0x800700EA)