Share via


DocumentProperties Test (Ansi)

This automated test exercises the printer driver's implementation of the DocumentProperty API. The test calls the API by using various data. The test then validates the returned values.

This document applies to the following test jobs:

  • DocumentProperties (ANSI) test job

  • DocumentProperties (Unicode) test job

Test details

Associated requirements

Device.Imaging.Printer.Base.DocumentProperties

See the device hardware requirements.

Platforms

Windows 7 (x64) Windows 7 (x86) Windows 8 (x64) Windows 8 (x86) Windows Server 2012 (x64) Windows Server 2008 R2 (x64) Windows 8.1 x64 Windows 8.1 x86 Windows Server 2012 R2

Expected run time

~10 minutes

Categories

Certification Functional

Type

Automated

 

Running the test

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

Troubleshooting

For troubleshooting information, see Troubleshooting Device.Imaging Testing.

More information

The Document Properties test exercises a printer driver's user interface (UI) by using multiple well-formed and malformed parameters to call the DocumentProperties API and then validating the results.

The difference between the Document Properties ANSI test and the Document Properties Unicode test is that the buffers in the Document Properties ANSI test are based on ANSI characters (CHARs), and the buffers in the Document Properties Unicode test are based on Unicode wide characters (WCHARs).

For each test case, the test prints the parameters that the test uses in the log file. The printer driver passes this test if the log file does not contain any failures. The printer driver fails this test if the log file shows that one or more test cases failed.

The following code example shows a sample log file.

<StartTest                 Title="DocumentPropertiesTEST"                 TUID="" CA="259184628680" LA="259190331028" >                <rti id="2701157395" />                <ctx id="4071736938" /></StartTest><Msg                 UserText="Testing Parameters permutation:" CA="259184695528" LA="259191739244" >                <rti id="2701157395" />                <ctx id="4071736938" /></Msg><Msg                 UserText="ParentWindow handle = NULL" CA="259187152000" LA="259197116980" >                <rti id="2701157395" />                <ctx id="4071736938" /></Msg><Msg                 UserText="PrinterHandle   = 0008B13C" CA="259187274076" LA="259198369668" >                <rti id="2701157395" />                <ctx id="4071736938" /></Msg><Msg                 UserText="DevName                                         = BadPrinterName" CA="259189194348" LA="259202784116" >                <rti id="2701157395" />                <ctx id="4071736938" /></Msg><Msg                 UserText="OutDevMode                   = 00000000" CA="259194212632" LA="259205347188" >                <rti id="2701157395" />                <ctx id="4071736938" /></Msg><Msg                 UserText="InDevMode                      = 0026D838" CA="259194365944" LA="259207533880" >                <rti id="2701157395" />                <ctx id="4071736938" /></Msg><Msg                 UserText="fMode == 0x5E" CA="259195053008" LA="259208248332" >                <rti id="2701157395" />                <ctx id="4071736938" /></Msg><Msg                 UserText="DM_COPY | DM_PROMPT | DM_MODIFY | DM_ADVANCED | DM_USER_DEFAULT" CA="259199944896" LA="259209030276" >                <rti id="2701157395" />                <ctx id="4071736938" /></Msg><Msg                 UserText="Checking return from DocumentProperties():" CA="259578756012" LA="259579142928" >                <rti id="2701157395" />                <ctx id="4071736938" /></Msg><Msg                 UserText="No Errors found" CA="259581819836" LA="259585130656" >                <rti id="2701157395" />                <ctx id="4071736938" /></Msg><EndTest                 Title="DocumentPropertiesTEST"                 TUID=""                 Result="Pass"                 Repro="SUCCESS: Variation: 0" CA="259582037324" LA="259586679184" >                <rti id="2701157395" />                <ctx id="4071736938" /></EndTest>

 

 

Send comments about this topic to Microsoft