Present Validation 2 - ColorConverting

This automated test validates the Present() method.

Specifically, this test performs the following tasks:

  • Shrinks or stretches the height

  • Shrinks or stretches the width

  • Clips to the source area

  • Clips to the destination area

  • Overrides the destination window

The test performs these tasks individually and in combination. It then verifies the resulting output for correctness.

This topic applies to the following test jobs:

  • Present Validation 2

  • Present Validation 2 (WoW64)

  • Present Validation 2 - ColorConverting

  • Present Validation 2 - ColorConverting (WoW64)

  • Present Validation 2 - GammaPresent

  • Present Validation 2 - GammaPresent (WoW64)

  • Present Validation 2 - Present

  • Present Validation 2 - Present (WoW64)

Test details

   
Specifications
  • Device.Graphics.AdapterRender.MinimumDirectXLevel
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) 45
Category Compatibility
Timeout (in minutes) 2700
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: Graphic Adapter or Chipset Testing Prerequisites.

Troubleshooting

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

For troubleshooting information, see Troubleshooting Device.Graphics Testing.

More information

This test is similar to the standard Present Validation test. The difference is that Present Validation 2 resets the device into a state where the back buffer and the front buffer have different formats (if the call to the CheckDeviceFormatConversion method was successful). The test performs a comparison with a reference image that the Microsoft Direct3D API generates. The driver must perform the color conversion between those two formats. (Direct3D does not perform any software emulation.)

This test uses the IDirect3DSwapChain9::Present method with the D3DPRESENT_LINEAR_CONTENT option.

If the driver supports gamma presentation (that is, the driver exposes the D3DCAPS3 capabilities option D3DCAPS3_LINEAR_TO_SRGB_PRESENTATION), a gamma-corrected presentation should occur. This test verifies the correct output by post-processing the reference image via gamma 2.2 correction. If the driver claims that gamma presentation is not supported, the test verifies that no gamma correction occurs.

The test performs the following tasks:

  • Scales the color channels to [0..1)

  • Calculates Channel = pow( Channel, 1 / Gamma )

  • Scales the result back to int [0..256)

Warning

   Gamma presentation is supported only on a desktop that has a 32-bit color depth.

 

Command syntax

Command option Description

Present2.exe -M:1 -dx9 -whql -logclean

Runs the Present Validation 2 test job.

Present2.exe -M:1 -whql -logclean

Runs the Present Validation 2 (WoW64) test job.

Present2.exe -ColorConverting -src:ref -M:1 -whql -logclean

Runs both the Present Validation 2 - ColorConverting test job and the Present Validation 2 - ColorConverting (WoW64) test job.

Present2.exe -GammaPresent -src:ref -M:1 -whql -logclean

Runs both the Present Validation 2 - GammaPresent test job and the Present Validation 2 - GammaPresent (WoW64) test job.

Present2.exe -Present -src:ref -M:1 -whql -logclean

Runs both the Present Validation 2 - Present test job and the Present Validation 2 - Present (WoW64) test job.

Note

   For command-line help for this test binary, type /?.

 

File list

File Location

Configdisplay.exe

<[testbinroot]>\nttest\windowstest\tools\

D3d10ref.dll

<[testbinroot]>\nttest\graphics\d3d\support\

D3d11ref.dll

<[testbinroot]>\nttest\windowstest\graphics\d3d\support\

D3dcompiler_test.dll

<[testbinroot]>\nttest\windowstest\graphics\d3d\support\

D3dref9.dll

<[testbinroot]>\nttest\windowstest\graphics\d3d\support

D3dref8.dll

<[testbinroot]>\nttest\windowstest\graphics\d3d\support\

D3dx10_test.dll

<[testbinroot]>\nttest\windowstest\graphics\d3d\support\

D3dx11_TEST.dll

<[testbinroot]>\nttest\windowstest\graphics\d3d\support\

D3dx9_TEST.dll

<[testbinroot]>\nttest\windowstest\graphics\d3d\support\

D3dx8d.dll

<[testbinroot]>\nttest\windowstest\graphics\d3d\support\

Fpstate.dll

<[testbinroot]>\nttest\windowstest\graphics\d3d\utility\

Modechange.exe

<[testbinroot]>\nttest\windowstest\graphics\d3d\utility\

TDRWatch.exe

<[testbinroot]>\nttest\windowstest\graphics\

Vbswap.x

<[testbinroot]>\nttest\windowstest\graphics\d3d\conf\

 

Parameters

Parameter name Parameter description
MODIFIEDCMDLINE Additional command line arguments for test executable
LLU_NetAccessOnly LLU Name of net user
MONITOR Display device to test
ConfigDisplayCommandLine Custom Command Line for ConfigDisplay. Default: logo
TDRArgs /get or /set