Share via

D3D9 Overlay - CreateAdditionalSwapChain

  • Article

This manual test calls into CreateAdditionalSwapChain with valid and invalid parameters. It attempts to check the largest overlay size, as well as the smallest reported as supported by the driver.

Test details

   
Specifications
  • Device.Graphics.WDDM11.DisplayRender.D3D9Overlay.D3D9Overlay
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) 1
Category Compatibility
Timeout (in minutes) 60
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.

In addition, this test requires the following:

  • A device driver with D3D9 support that exposes D3DCAPS_OVERLAY.

Troubleshooting

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

For troubleshooting information, see Troubleshooting Device.Graphics Testing.

The test calls into CheckDeviceOverlayType with valid and invalid parameters. It attempts to check the largest overlay size, as well as the smallest reported as supported by the driver.

The test might return SKIP if the driver does not expose D3DCAPS_OVERLAY. Some cases might skip if the back buffer format or mode is not supported during D3D device creation.

More information

This test executes multiple test cases targeting IDirect3D9Ex::CreateDevice with IDirect3D9ExDevice::CreateSwapChain. It uses different sizes of both valid and invalid display modes, flags, and overlay sizes. It also tests different types of swap chain creations.

The test runs the following test jobs:

CreateDeviceEx:

  • Verify successful creation of non-RGB backbuffer if non-RGB overlay is supported.

  • Verify swapeffect fails full screen and is successfully windowed.

  • Verify swapeffect fails when using an interface other than D3D9OverlayExtended.

  • Verify that Multisampling fails.

  • Test case in which a D3D9Ex overlay device has been created by one process, and then another process attempts to create another D3D9Ex swap chain.

  • Verify CreateDeviceEx with D3DPRESENTFLAG_OVERLAY_LIMITEDRGB successfully limits color range during present time of 16 to 235 if supported by the driver. For more information, see the PresentEx test cases below.

  • Verify CreateDeviceEx with D3DPRESENTFLAG_OVERLAY_YCbCr_BT709 successfully increases luma and chroma sampling, as well as limiting the RGB values to between 16 and 235 during present time if supported by the driver. For more information, see the PresentEx test cases below.

  • Verify CreateDeviceEx with D3DPRESENTFLAG_OVERLAY_YCbCr_xvYCC successfully increases RGB color range between 1 and 255 during present time if supported by the driver. For more information, see the PresentEx test cases below.

  • Verify CreateDeviceEx with unsupported D3DPRESENTFLAG (fails or succeeds).

CreateAdditionalSwapChain:

  • Verify creation of additional swap chains fails both through CreateAdditionalSwapChain and through reset of an existing swap chain.

Command syntax

Command option Description

D3D9OverlayTest CreateAdditionalSwapChain -whql -logclean

This command runs the D3D9 Overlay - CreateAdditionalSwapChain test job. Without any options, the test enumerates all but some extreme cases.

TestCasePriority:[0, 1, 2]

Specifies the priority of the test cases to run. 0 will run build verification test (BVT)level test cases 1,2 more aggressive test cases.

LogLevel[0, 1, 2]

The test has the ability to be very verbose in its logging methods. By default, level 0 is set; however, level one will gather increased logging info per test cases including many stream states/blt states set. Level 2 will gather all adjusted stream states and blt states, as well as any configuration information.

Note

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

 

File list

File Location

Configdisplay.exe

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

D3D9OverlayTest.exe

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

TDRWatch.exe

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

 

Parameters

Parameter name Parameter description
MODIFIEDCMDLINE Additional command line arguments for test executable
LLU_NetAccessOnly LLU Name of net user
ConfigDisplayCommandLine Custom Command Line for ConfigDisplay. Default: logo