Share via


DXGI Mode Enumeration

This automated test verifies that the IDXGIOutput::FindClosestMatchingMode method is correctly implemented.

This test generates a predetermined set of target modes, and enumerates the available modes. For each target mode, the test predicts the mode that the FindClosestMatchingMode method should return. In accordance with the DirectX Graphics Infrastructure (DXGI) specification, when the test is seeking a match, the test prioritizes mode attributes according to the following order:

  • Format bit depth

  • Width

  • Height

  • Refresh rate

This topic is applicable to the following test jobs:

  • DXGI Mode Enumeration

  • DXGI Mode Enumeration (WoW64)

  • DXGI Mode Enumeration - multihead (WoW64)

Test details

Associated requirements

Device.Graphics.WDDM12.Display.ModeEnumeration

See the device hardware requirements.

Platforms

Windows RT (ARM-based) Windows 8 (x64) Windows 8 (x86) Windows Server 2012 (x64) Windows RT 8.1 Windows 8.1 x64 Windows 8.1 x86 Windows Server 2012 R2

Expected run time

~30 minutes

Categories

Certification Functional

Type

Automated

 

Running the test

Before you run the test, complete the test setup as described in the test requirements: Graphic Adapter or Chipset Testing Prerequisites

Note  

If you run the DXGI Mode Enumeration - multihead (WoW64) test on a system without multiple monitors, you will be prompted to add a second monitor. If your device family does not support multimon, select "Continue" to force the test to run in single monitor configuration. Some tests can only be run on systems with multiple monitors, in which case the test will be skipped.

 

Troubleshooting

For troubleshooting information, see Troubleshooting Device.Graphics Testing.

This test will always return Pass or Fail. To review test details, review the test log from the DTM Studio.

The test reports a failure if the mode that the method returns does not match the predicted mode, or if the method fails when a matching mode does exist. A recent addition is the DXGI —Mode Enumeration— Multi-head test job; the only difference is that it targets display adapters that expose dual-view capabilities.

More information

.

Command syntax

Command option Description

DXGIModeenumeration -whql -logclean

Runs both the DXGI Mode Enumeration test job and the DXGI Mode Enumeration (WoW64) test job.

DXGIModeenumeration.exe -whql -logclean -bvt

Runs the DXGI Mode Enumeration - multihead (WoW64) test job.

 

Note  

For command-line help for this test binary, type /?

 

File list

File Location

Configdisplay.exe

<testbinroot>\nttest\windowstest\tools\

D3d10ref.dll

<testbinroot>\nttest\windowstest\graphics\d3d\support\

D3d10SDKLayers.dll

<testbinroot>\nttest\windowstest\graphics\d3d\support\

D3d11ref.dll

<testbinroot>\nttest\windowstest\graphics\d3d\support\

D3d11SDKLayers.dll

<testbinroot>\nttest\windowstest\graphics\d3d\support\

D3dcompiler_test.dll

<testbinroot>\nttest\windowstest\graphics\d3d\support

D3dx10_test.dll

<testbinroot>\nttest\windowstest\graphics\d3d\support

D3dx11_TEST.dll

<testbinroot>\nttest\windowstest\graphics\d3d\support\

DXGIModeenumeration.exe

<testbinroot>\nttest\windowstest\graphics\d3d\conf\

TDRWatch.exe

<testbinroot>\nttest\nttest\windowstest\graphics\

 

 

 

Send comments about this topic to Microsoft