Share via

Present Validation 2 (FullScreen)

  • Article

This automated test verifies that all modes that the EnumAdapterModes method reports for the device are available to applications.

The test uses the following parameters: back buffer format, screen resolution, present intervals, swap effects, and multisample types.

The DoNotWait test calls the swap chain's Present method in a loop, passes the D3DPRESENT_DONOTWAIT option (in full-screen mode), and uses the D3DPRESENT_INTERVAL_ONE value. As a result, the driver's queue of frames will exceed the allowed maximum of three. The DoNotWait test expects the driver to return control to the application by using the D3DERR_WASSTILLDRAWING error code. If the error code is not returned, the test fails.

The LockDoNotWait test is similar to the DoNotWait test but occurs on a surface (the back buffer). The same behavior is expected of the driver. If the error code is not returned, the test fails.

This topic applies to the following test jobs:

  • Present Validation 2 (FullScreen)

  • Present Validation 2 (FullScreen) (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) 9
Category Compatibility
Timeout (in minutes) 540
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

The test displays on-screen pass-or-fail compliance and writes the results to a log file that is named Present2.xml. Present2.xml is written to the %windir%\dxlogs directory.

If the call to the Reset method fails, you can check the values that the test used for the back buffer format and size in the log file. If the image comparison fails, the test prints the image-comparison statistics, just like the other Present Validation tests in the group.

The following table lists the image surfaces that the test uses. If you specify the -Save command option, the test saves these files.

File Location

Texture.dds

The texture that is used to fill the quad that is used in Present operations.

SourceSurface.bmp

The source surface in the back buffer. For full-screen Present operations, this surface is the whole buffer.

DestSurface.bmp

The destination surface in the front buffer. For full-screen Present operations, this surface is the whole buffer.

RefSurface.bmp

The reference surface, as computed by the Microsoft Direct3D API.

DiffSurface.bmp

The difference between the front buffer and the reference image.

FrontBuffer.bmp

The contents of the front buffer.

 

Command syntax

Command option Description

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

Runs the Present Validation 2 (FullScreen) test job.

Present2_fullscreen.exe -M:1 -whql -logclean

Runs the Present Validation 2 (FullScreen) (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\windowstest\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\

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\

Fpstate.dll

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

Modechange.exe

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

Present2_fullscreen.exe

<[testbinroot]>\nttest\

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