Share via

D3D9 Overlay - CheckDeviceOverlayType

  • Article

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

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

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\

 

 

 

Send comments about this topic to Microsoft