Поделиться через

Проверка правильности 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.

Сведения об устранении неполадок см. в разделе Troubleshooting 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

    Эта команда создает XML-snapshot в файле GDLsnapshot.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-snapshot, но не самого snapshot. Схему можно найти в файле GDLschema.xsd. Эта команда отображает параметр -GenerateSchema и параметр -DoNotGenerateXmlSnapshot . Этот параметр отключает snapshot создание. По умолчанию Gdlcheck создает XML-snapshot, если не указан параметр -DoNotGenerateXmlSnapshot.

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

    Эта команда показывает, как использовать параметр -PrefaceFile в Gdlcheck для указания файла предисловия. Чтобы выполнить этот тест, закомментируйте или удалите строку "*Include: stdschmx.gdl" из файла basic.gdl, так как файл preface.gdl уже содержит эту строку. Результат выполнения этой команды совпадает с результатом первого примера команды.

  • GDLCheck.exe -DisplaySynthesizedFeatures -DoNotGenerateXmlSnapshot synfea.gdl

    Эта команда показывает, как использовать параметр -DisplaySynthesizedFeatures для проверки создания синтезированных признаков. В следующих выходных данных отладки показан пример того, что происходит при выполнении этой команды. Обратите внимание, что поскольку эта команда не использует параметр -DoNotGenerateXmlSnapshot, тест не создает XML-snapshot.

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

    Обратите внимание, что вам не нужно использовать параметр -DoNotGenerateXmlSnapshot , если вы хотите использовать параметр -DisplaySynthesizedFeatures . Вы также можете использовать следующую команду:

    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

  • Аргумент -ParserContext в GDLCheck можно использовать для проверки нескольких корневых файлов GDL в рамках одного выполнения GDLCheck. Ниже приведен синтаксис этой команды.

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

    В этом примере также показано, как использовать параметр -Personality, чтобы указать личность для создания XML-snapshot с учетом личности.

Параметры

Имя параметра Описание параметра
CommandStringOptions Аргументы команды.
LLU_LAU Логический локальный пользователь.
LLU_NetAccessOnly Логический локальный пользователь: только сетевой доступ.
TestExecutableName Проверьте имя исполняемого файла.
WDKPrinterName Имя принтера.