Delen via


Print Processor API Test

This automated test loads the print processor into its own memory space and verifies that all required interfaces are present. Furthermore, the test tries to call these interfaces to make sure that the print processor is robust.

Test details

   
Specifications
  • Device.Imaging.Printer.Base.printProcessor
Platforms
  • Windows 10, client editions (x86)
  • Windows 10, client editions (x64)
  • Windows Server 2016 (x64)
  • Windows 10, client editions (Arm64)
Supported Releases
  • 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
  • Next update to Windows 10
Expected run time (in minutes) 2
Category Scenario
Timeout (in minutes) 120
Requires reboot false
Requires special configuration false
Type automatic

 

Additional documentation

Tests in this feature area might have additional documentation, including prerequisites, setup, and troubleshooting information, that can be found in the following topic(s):

Running the test

Before you run the test, complete the test setup as described in the test requirements: Printer Testing Prerequisites.

Warning

   You must install all print processors on the system before you can test these processors. If you specify the print processor, the test evaluates the print processor and the default printer. If you do not install a printer, the test only evaluates whether the print processor supports the required interfaces.

 

Troubleshooting

For generic troubleshooting of HLK test failures, see Troubleshooting Windows HLK Test Failures.

For troubleshooting information, see Troubleshooting Device.Imaging Testing.

More information

The Print Processor API test calls LoadLibrary function on the specified print processor to load it into its own process. It then calls GetProcAddress on the following six required endpoints:

  • OpenPrintProcessor

  • ClosePrintProcessor

  • ControlPrintProcessor

  • EnumPrintProcessorDatatypesW

  • PrintDocumentOnPrintProcessor

  • GetPrintProcessorCapabilities

If the test cannot find one of these required endpoints, the test logs a failure.

Because print processors are capable of running many functions, it is impossible to write an automated test that can test any particular print processor. It We recommend that you test the print processor's functionality manually.

Success: The Print Processor API test passes if the rollup at the end of the log file contains no failures.

Failure: The Print Processor API test fails if the rollup at the end of the log file contains one or more failures.

Parameters

Parameter name Parameter description
LLU_NetAccessOnly Logical Local User: Network Access only.
TestExecutableName Test Executable name.
WDKPrinterName Printer name.
LLU_LAU Logical Local User.
LLU_LSU Logical Local User.