Freigeben über

GDL-Test auf Korrektheit

  • Artikel

Dieser automatisierte Test wird vom GDLCheck-Tool ausgeführt. Das Tool führt eine Syntaxüberprüfung der allgemeinen Beschreibungssprache (GDL) durch, die GDL-Dateien analysiert und lädt, Konfigurationen angibt, XML-Momentaufnahmen abruft und nach Syntaxfehlern sucht.

Testdetails

   
Spezifikationen
  • Device.Imaging.Printer.Base.GDLFile
  • Device.Imaging.3DPrinter.Base.GDLFile
Plattformen
  • Windows 10, Client-Editionen (x86)
  • Windows 10, Client-Editionen (x64)
  • Windows Server 2016 (x64)
  • Windows 10, Client-Editionen (Arm64)
Unterstützte Versionen
  • Windows 10
  • Windows 10, Version 1511
  • Windows 10, Version 1607
  • Windows 10, Version 1703
  • Windows 10, Version 1709
  • Windows 10, Version 1803
  • Windows 10, Version 1809
  • Windows 10, Version 1903
  • Nächstes Update auf Windows 10
Voraussichtliche Laufzeit (in Minuten) 2
Kategorie Szenario
Zeitüberschreitung (in Minuten) 120
Neustart erforderlich false
Erfordert eine spezielle Konfiguration false
Typ automatic

 

Zusätzliche Dokumentation

Tests in diesem Funktionsbereich enthalten möglicherweise zusätzliche Dokumentation, einschließlich Informationen zu Voraussetzungen, Einrichtung und Fehlerbehebung, die in den folgenden Themen zu finden sind:

Ausführen des Tests

Bevor Sie den Test ausführen, schließen Sie die Testeinrichtung wie in den Testanforderungen beschrieben ab: Testvoraussetzungen für Drucker.

Problembehandlung

Allgemeine Informationen zur Problembehandlung von HLK-Testfehlern finden Sie unter Problembehandlung von Windows HLK-Testfehlern.

Informationen zur Problembehandlung finden Sie unter Problembehandlung bei Device.Imaging-Tests.

Weitere Informationen

Dieser Test sendet alle Analysefehler und die Debugausgabe an „Gdlcheck.xml“. Der Test verarbeitet Befehlszeilenargumente von links nach rechts. Jedes Argument wird mit einem Leerzeichen vom nächsten getrennt. Sie müssen alle Optionen angeben, bevor Sie den GDL-Stammdateinamen angeben.

Sie können dieses Testtool über das Microsoft® Windows Driver Kit (WDK) oder selbst über die Eingabeaufforderung ausführen. Dieses Tool protokolliert Ergebnisse in einer Windows Test Technologies-Protokolldatei (WTT-Protokolldatei). Sie können das Tool so konfigurieren, dass Informationen auf unterschiedlichen Verbositätsebenen protokolliert werden. Das Tool benötigt die Allgemeine Druckerbeschreibungs- (GPD) oder die GDL-Datei, die Sie überprüfen möchten, und alle anderen GPD- oder GDL-Dateien, auf die die Stammdatei verweist.

GDLCheck schreibt die gesamte Debugausgabe in die Datei „GDLCheck.xml“.

Die Syntax dieses Tools lautet wie folgt:

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.

In der folgenden Liste werden einige Beispiele für GDLCheck-Befehle beschrieben:

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

    Dieser Befehl erzeugt eine XML-Momentaufnahme in der Datei „GDLsnapshot.xml“ mithilfe der Standardgeräte- und Dokumentkonfigurationen. Die Datei „basic.gdl“ implementiert die grundlegenden Features, die Sie zum Erfüllen der von der Datei „stdschem.gdl“ definierten Stammkonstruktproduktionen benötigen. Die folgende Debugausgabe zeigt ein Beispiel dafür, was auftritt, wenn Sie die Option -DisplayValidatedConfiguration angeben.

    ==== 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

    Dieser Befehl erzeugt das Schema für die XML-Momentaufnahme, aber nicht die Momentaufnahme selbst. Sie finden das Schema in der Datei „GDLschema.xsd“. Dieser Befehl zeigt die Option -GenerateSchema und die Option -DoNotGenerateXmlSnapshot. Diese Option deaktiviert die Momentaufnahmeerstellung. Gdlcheck erzeugt standardmäßig eine XML-Momentaufnahme, es sei denn, Sie geben die Option -DoNotGenerateXmlSnapshot an.

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

    Dieser Befehl zeigt, wie Sie die Option -PrefaceFile in Gdlcheck verwenden, um eine Präfixdatei anzugeben. Um diesen Test auszuführen, kommentieren oder entfernen Sie die Zeile „*Include: "stdschmx.gdl"“ aus der Datei „basic.gdl“, da die Datei „preface.gdl“ bereits diese Zeile enthält. Das Ergebnis der Ausführung dieses Befehls entspricht dem Ergebnis des ersten Beispielbefehls.

  • GDLCheck.exe -DisplaySynthesizedFeatures -DoNotGenerateXmlSnapshot synfea.gdl

    Dieser Befehl zeigt, wie Sie die Option -DisplaySynthesizedFeatures verwenden, um die Erstellung von synthetisierten Features zu überprüfen. Die folgende Debugausgabe zeigt ein Beispiel dafür, was auftritt, wenn Sie diesen Befehl ausführen. Beachten Sie, dass dieser Befehl nicht die Option -DoNotGenerateXmlSnapshot verwendet und somit keine XML-Momentaufnahme erstellt.

    === 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 ===

    Beachten Sie, dass Sie die Option -DoNotGenerateXmlSnapshot nicht verwenden müssen, wenn Sie die Option -DisplaySynthesizedFeatures verwenden möchten. Sie können auch den folgenden Befehl verwenden:

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

    Dieser Befehl erzeugt die folgende Debugausgabe:

    === 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

    Dieser Befehl zeigt, wie Sie die Optionen -DeviceConfiguration und -DocumentConfiguration verwenden, um Ihre eigenen Geräte- und Dokumentkonfigurationen zu definieren. Die folgende Debugausgabe zeigt ein Beispiel dafür, was auftritt, wenn Sie diesen Befehl ausführen.

    ==== 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

  • Sie können das Argument -ParserContext in GDLCheck verwenden, um mehr als eine GDL-Stammdatei bei einzigen Ausführung von GDLCheck zu überprüfen. Die Syntax für den Befehl lautet wie folgt:

    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

    In diesem Beispiel wird auch gezeigt, wie Sie die Option -Personality verwenden, um eine Persönlichkeit für die Erstellung der persönlichkeitsfähigen XML-Momentaufnahme anzugeben.

Parameter

Parametername Parameterbeschreibung
CommandStringOptions Befehlsargumente.
LLU_LAU Logischer lokaler Benutzer (Logical Local User).
LLU_NetAccessOnly Logischer lokaler Benutzer: nur Netzwerkzugriff.
TestExecutableName Name der ausführbaren Testdatei.
WDKPrinterName Druckername.