D3D9 Overlay - CreateDeviceEx Test
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
Associated requirements |
Device.Graphics.WDDM11.DisplayRender.D3D9Overlay.D3D9Overlay |
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 that supports D3DCaps9.Caps D3DCAPS_OVERLAY.
Troubleshooting
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\ |