共用方式為

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 Testing 進行疑難排解。

詳細資訊

此測試會將所有剖析錯誤和偵錯輸出傳送至Gdlcheck.xml。 測試會處理從左至右的命令列引數。 每個引數都會以空白字元分隔下一個引數。 您必須先指定所有選項，才能指定 GDL 根檔案名。

您可以從 Microsoft® Windows 驅動程式套件 (WDK) 或從命令提示字元本身執行此測試控管。 此工具會將結果記錄至 Windows Test Technologies (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 選項。 此選項會關閉快照集建立。 根據預設，除非您指定 -DoNotGenerateXmlSnapshot 選項，否則 Gdlcheck 會產生 XML 快照集。

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

    此命令示範如何在 Gdlcheck 中使用 -PrefaceFile 選項來指定前置檔案。 若要執行此測試，請將 「*Include： 」stdschmx.gdl「 行從 basic.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=1 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 印表機名稱。