通过

GDL 正确性测试

  • 项目

此自动测试由 GDLCheck 工具运行。 该工具执行通用描述语言 (GDL) 语法检查，该检查可分析和加载 GDL 文件，指定配置，获取 XML 快照，并查找语法错误。

测试详细信息

   
规范
  • Device.Imaging.Printer.Base.GDLFile
  • Device.Imaging.3DPrinter.Base.GDLFile
平台
  • Windows 10，客户端版本 (x86)
  • Windows 10，客户端版本 (x64)
  • Windows Server 2016 (x64)
  • Windows 10，客户端版本 (Arm64)
支持的版本
  • Windows 10
  • Windows 10 版本 1511
  • Windows 10 版本 1607
  • Windows 10 版本 1703
  • Windows 10 版本 1709
  • Windows 10 版本 1803
  • Windows 10 版本 1809
  • Windows 10 版本 1903
  • Windows 10 的下一次更新
预计运行时间（以分钟为单位） 2
类别 方案
超时（以分钟为单位） 120
需要重启 false
需要特殊配置 false
类型 automatic

 

其他文档

此功能区域中的测试可能会有其他文档，包括先决条件、设置和故障排除信息，这些内容可在以下主题中找到：

运行测试

在运行测试之前，请按照如下测试要求中所述完成测试设置：打印机测试先决条件。

故障排除

有关 HLK 测试失败的常规故障排除，请参阅排查 Windows HLK 测试失败问题。

有关故障排除信息，请参阅排查 Device.Imaging 测试问题。

更多信息

此测试将所有分析错误和调试输出发送到 Gdlcheck.xml。 测试从左到右处理命令行参数。 每个参数都用空格字符与下一个参数隔开。 在指定 GDL 根文件名之前，必须指定所有选项。

可以从 Microsoft® Windows 驱动程序工具包 (WDK) 或命令提示符运行此测试工具。 此工具将结果记录到 Windows 测试技术 (WTT) 日志文件。 可以配置此工具，以不同的详细程度记录信息。 此工具需要使用你要验证的根通用打印机描述 (GPD) 或 GDL 文件，以及根文件引用的任何其他 GPD 或 GDL 文件。

GDLCheck 将所有调试输出写入到 GDLCheck.xml 文件。

此示例的语法如下所示：

GDLCheck.exe [-Verbosity=n], where n is a number from 0 to 4 specifying the verbosity level of parser messages. Verbosity 4 is the most verbose and Verbosity 0 is the least verbose. [-Personality[=persona]] Generate Personality Aware snapshot. (To enable all personalities, use -Personality alone.) [-DisplaySynthesizedFeatures] [-GenerateSchema] (GDLschema.xsd) for XML snapshot. [-DoNotGenerateXMLSnapshot] [-DisplayOnlyStickyFeatures] [-DisplayValidatedConfiguration] [-ParserContext=n] where n is a number from 0 to 9. Initial context is 0. [-PrefaceFile=<full path to file that holds Preface>] [-DeviceConfiguration[=Feature1.Option1[:Feature2.Option2[:Feature3.Option3...]]] [-DocumentConfiguration[=Feature1.Option1[:Feature2.Option2[:Feature3.Option3...]]] (Always generates XML Snapshot.) <-PrinterName=<name of an installed printer> | GDL root file path1 [GDL root file path2...]> [-?] Display this message.

以下列表描述了一些示例 GDLCheck 命令：

  • GDLCheck.exe -DisplayValidatedConfiguration -DeviceConfiguration -DocumentConfiguration basic.gdl

    此命令使用默认设备配置和文档配置在 GDLsnapshot.xml 文件中生成 XML 快照。 basic.gdl 文件实现生成 stdschem.gdl 文件定义的根构造所需的基本功能。 以下调试输出显示了指定 -DisplayValidatedConfiguration 选项时的输出示例。

    ==== Validated Configuration ====PaperSize:LETTERResolution:Option1RESDLL:UniresDLLInputBin:UPPERIf you execute the same command with hplj5si.gdl (instead of basic.gdl), you will see the following debug output.==== Validated Configuration ====Memory:4096KBPrinterHardDisk:FALSEDuplexUnit:InstalledPageProtect:OFF==== Validated Configuration ====Memory:4096KBPrinterHardDisk:FALSEDuplexUnit:InstalledPageProtect:OFFPaperSize:LETTEROrientation:PORTRAITDuplex:NONEResolution:Option1Halftone:HT_PATSIZE_AUTORESDLL:UniresDLLOutputBin:Option1Collate:OFFStapling:Option1InputBin:Option1

  • GDLCheck.exe -GenerateSchema -DoNotGenerateXmlSnapshot basic.gdl

    此命令生成 XML 快照的架构，而不是快照本身。 可以在 GDLschema.xsd 文件中找到该架构。 此命令显示 -GenerateSchema 选项和 -DoNotGenerateXmlSnapshot 选项。 此选项用于关闭快照创建。 默认情况下，Gdlcheck 生成 XML 快照，除非指定 -DoNotGenerateXmlSnapshot 选项。

  • GDLCheck.exe -PrefaceFile=preface.gdl -DisplayValidatedConfiguration -DeviceConfiguration -DocumentConfiguration basic.gdl

    此命令显示了如何在 Gdlcheck 中使用 -PrefaceFile 选项来指定前言文件。 要执行此测试，请从 basic.gdl 文件中注释掉或删除 *Include: "stdschmx.gdl" 行，因为 preface.gdl 文件已包含此行。 运行此命令的结果与第一个示例命令的结果相同。

  • GDLCheck.exe -DisplaySynthesizedFeatures -DoNotGenerateXmlSnapshot synfea.gdl

    此命令显示了如何使用 -DisplaySynthesizedFeatures 选项来验证合成功能的创建。 以下调试输出显示了运行此命令时的输出示例。 请注意，由于此命令不使用 -DoNotGenerateXmlSnapshot 选项，因此测试不会创建 XML 快照。

    === Begin Contents of Synthesized Features Buffer ===*Feature: SynFea_InputBinENVFEED{*FeatureType: SYNTHESIZED_PROPERTY*Name: "Optional Envelope Feeder"*Option: NotInstalled{*Name: "Not installed"*Constraints: InputBin.ENVFEED}*Option: Installed{*Name: "Installed"}}=== End Contents of Synthesized Features Buffer ===

    请注意，如果要使用 -DisplaySynthesizedFeatures 选项，则无需使用 -DoNotGenerateXmlSnapshot 选项。 还可使用以下命令：

    GDLCheck.exe -DisplaySynthesizedFeatures -DisplayValidatedConfiguration -DeviceConfiguration -DocumentConfiguration synfea.gdl

    此命令将生成以下调试输出：

    === Begin Contents of Synthesized Features Buffer ===*Feature: SynFea_InputBinENVFEED{*FeatureType: SYNTHESIZED_PROPERTY*Name: "Optional Envelope Feeder"*Option: NotInstalled{*Name: "Not installed"*Constraints: InputBin.ENVFEED}*Option: Installed{*Name: "Installed"}}=== End Contents of Synthesized Features Buffer ======= Validated Configuration ====SynFea_InputBinENVFEED:NotInstalled==== Validated Configuration ====SynFea_InputBinENVFEED:NotInstalledPaperSize:LETTERResolution:Option1RESDLL:UniresDLLInputBin:UPPER

  • GDLCheck.exe -DisplayValidatedConfiguration -DeviceConfigurationMemory.8192KB:PrinterHardDisk.TRUE -cOrientation.LANDSCAPE_CC90:Resolution.Option2:PaperSize.LEGAL hplj5si.gdl

    此命令显示了如何使用 -DeviceConfiguration 和 -DocumentConfiguration 选项来定义自己的设备配置和文档配置。 以下调试输出显示了运行此命令时可能的输出示例。

    ==== Validated Configuration ====Memory:8192KBPrinterHardDisk:TRUEDuplexUnit:InstalledPageProtect:OFF==== Validated Configuration ====Memory:8192KBPrinterHardDisk:TRUEDuplexUnit:InstalledPageProtect:OFFPaperSize:LEGALOrientation:LANDSCAPE_CC90Duplex:NONEResolution:Option2Halftone:HT_PATSIZE_AUTORESDLL:UniresDLLOutputBin:Option1Collate:OFFStapling:Option1InputBin:Option1

  • 可以在 GDLCheck 中使用 -ParserContext 参数，在单次执行 GDLCheck 中验证多个根 GDL 文件。 下面是此命令的语法：

    GDLCheck.exe -Preface=c:\test\preface.gdl -DisplayValidatedConfiguration -DeviceConfiguration -DocumentConfiguration c:\test\basic.gdl -ParserContext=1 -Preface=c:\test\preface.gdl -DisplayValidatedConfiguration -Verbosity=1 -Personality=Persona1 -GenerateSchema -DeviceConfiguration -DocumentConfiguration c:\test\personatest.gdl

    此示例还显示了如何使用 -Personality 选项来指定用于生成个人设置感知型 XML 快照的个人设置。

参数

参数名称 参数说明
CommandStringOptions 命令参数。
LLU_LAU 逻辑本地用户。
LLU_NetAccessOnly 逻辑本地用户：仅限网络访问。
TestExecutableName 测试可执行文件名。
WDKPrinterName 打印机名称。