Share via

D3D9 Overlay - CreateDeviceEx

  • Article

This automated test executes multiple test cases targeting IDirect3D9Ex::CreateDeviceEx. It uses different sizes of back buffer and formats, both with and without invalid flags and multisampling. It also uses both valid and invalid display modes, including rotated modes.

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 that supports D3DCaps9.Caps 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 CreateDeviceEx 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 does not present any frames to the screen; it simply iterates over test cases and produces a result of PASS or FAIL.

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

More information

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 interface other than D3D9OverlayExtended.

  • Verify that Multisampling fails.

  • Test case where a D3D9Ex overlay device has been created by one process, and then another process attempts to create another D3D9Ex swapchain.

  • Verify CreateDeviceEx with D3DPRESENTFLAG_OVERLAY_LIMITEDRGB successfully limits color range during present time to 16...235 if supported by the driver. See PresentEx tests below.

  • Verify CreateDeviceEx with D3DPRESENTFLAG_OVERLAY_YCbCr_BT709 successfully increases luma and chroma sampling, as well as limiting the RGB values to 16...235 during present time if supported by the driver. See PresentEx tests below.

  • Verify CreateDeviceEx with D3DPRESENTFLAG_OVERLAY_YCbCr_xvYCC successfully increases RGB color range to 1...255 during present time if supported by the driver. See PresentEx tests below.

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

CreateDeviceEx with ResetEx:

  • Verify CreateDeviceEx with specified D3DPRESENTFLAG is successfully overridden when a different D3DPRESENTFLAG is specified during ResetEx of the device.

    Warning

       Verify ResetEx with unsupported D3DPRESENTFLAG (fails or succeeds).

     

Command syntax

Command option Description

D3D9OverlayTest CreateDeviceEx -whql -logclean

This command runs the D3D9 Overlay - CreateDeviceEx test job.

Without any options, the test enumerates all but some extreme invalid argument test 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