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

Associated requirements

Device.Graphics.WDDM11.DisplayRender.D3D9Overlay.D3D9Overlay

See the device hardware requirements.

Platforms

Windows 7 (x64) Windows 7 (x86) Windows RT (ARM-based) Windows 8 (x64) Windows 8 (x86) Windows Server 2012 (x64) Windows Server 2008 R2 (x64) Windows RT 8.1 Windows 8.1 x64 Windows 8.1 x86 Windows Server 2012 R2

Expected run time

~1 minutes

Categories

Certification

Type

Manual

 

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 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\

 

 

 

Send comments about this topic to Microsoft