D3D9 Overlay - CheckDeviceOverlayType
This manual test executes multiple test cases targeting IDirect3D9ExOverlayExtension::CheckDeviceOverlayType. It uses different sizes of both valid and invalid display modes, including rotated modes.
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
The test runs the following test jobs:
CheckDeviceOverlayType:
Verify failure if Adapter index is out range.
Verify a NULL if pDisplayMode returns the same results as a pDisplayMode filled in with the current display mode.
Verify D3DERR_UNSUPPORTEDOVERLAYFORMAT by finding a successful overlay type, and cycling on OverlayFormats.
Verify D3DERR_UNSUPPORTEDOVERLAY is returned for an invalid width and height. The job finds a successful overlay type, and cycling on non-standard overlays sizes.
CheckDeviceOverlayType with CreateDeviceEx interaction:
Verify that a successful call to CheckDeviceOverlayType can result in a successful call to CreateDeviceEx.
Warning
This will always be the case until driver support is added.
Verify that a failed call to CheckDeviceOverlayType results in a failed call to CreateDeviceEx.
Warning
This test case will fail until driver support is added.
Command syntax
| Command option | Description |
|---|---|
D3D9OverlayTest CheckDeviceOverlayType -whql -logclean |
This command runs the D3D9 Overlay - CheckDeviceOverlayType test job. |
TestCasePriority:[0, 1, 2] |
Specifies the priority of the test cases to run. 0 runs build verification level (BVT) level test cases; 1 and 2 run 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; level 1 gathers increased logging information per test cases, including many stream states/blt states set; and level 2 gathers 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 |