D3D9 Overlay - CreateAdditionalSwapChain
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 |
|
| Platforms |
|
| Supported Releases |
|
| 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 |