Print Processor API Test

Print Processor API Test

Note  This content applies to the Windows Logo Kit (WLK). For the latest information using the new Windows Hardware Certification Kit (HCK), see Windows HCK User's Guide on the Windows Hardware Dev Center.

Type: Automated Test


The Print Processor API test tries to load the given print processor into its own process and verify that all of the required endpoints are available.


The Print Processor API Test calls LoadLibrary 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, it will log a failure.

Due to the large number of possible functions that print processors are capable of, it is impossible to write an automated test that can test any given print processor. It is recommended that the print processors functionality is also tested manually to ensure that it is working as expected.

Command Line Parameters:

Usage: ProcAPITest [-printer:Printer Name] [-proc:Print Processor Name] [-l]

-printer: <Printer Name> name of printer to test.

Use \\Server\Printer for remote printers.

If no printer name is specified, the default printer is tested.

-proc: Name of the print processor to test.

-l: Lists the print processor on the system.

All print processors must be installed on the system before they can be tested. If the print processor is specified, it will be tested in combination with the default printer, or if no printer is installed, it will only be tested on whether or not it supports the required interfaces.

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

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

Run Time: 5 minutes
Log File: ProcAPITest.xml
System Restart Required: No
Test Category:
Supported operating systems for Logo or Signature testing:
  • Windows 7

  • Windows Server 2008 R2

  • Windows Vista

  • Windows Server 2003

  • Windows XP



Software Requirements

The test tool requires the following software:

  • Supported operating system (see list above)

  • Software components included with the device that is being tested

Hardware Requirements

The test tool requires the following hardware:

  • Device to be tested

  • Computer that meets the minimum software requirements

  • Windows keyboard

  • Two-button pointing device

  • Color display monitor capable of at least 1024 by 768 resolution, 32-bits per pixel, 60 Hz

  • Hard drive with a minimum of 20 GB available on partition C:


  • x86

  • x64

  • Itanium

Test Assertions

Windows Logo Program: IMAGING-0030 Printer drivers must be correctly implemented based on the content of the WDK



Build date: 9/14/2012

Community Additions

© 2016 Microsoft