Multihead Support

This automated test validates the functional and operational specifications for the multihead support that is added in Microsoft® DirectX® 9.0.

Multihead support allows a single Direct3D device to drive multiple heads. This functionality uses resources such as surfaces and textures more efficiently than a multi-monitor configuration.

This topic applies to the following test jobs:

  • MultiHead Support

  • MultiHead Support (WoW64)

Test details

Associated requirements

Device.Graphics.AdapterRender.MinimumDirectXLevel

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

~20 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 software:

  • Microsoft DirectX 9.0 or later

Note  

If you run this 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.

The test writes the test results to a log file called Multihead.xml, and displays on-screen pass or fail compliance. The test log is written to the %windir%\dxlogs directory.

More information

When creating and resetting a multihead device, observe the following restrictions:

  • Each head must have the windowed mode set to FALSE.

  • Each head must have the same value set for the EnableAutoDepthStencil property.

  • If EnableAutoDepthStencil is TRUE, each head must have the same value for AutoDepthStencilFormat, back buffer dimension, and format.

  • You cannot create additional swap chains on a multihead device.

The test covers the core usage scenarios and a set of Direct3D interfaces (IDirect3D9 and IDirect3DDevice9). The interface methods include: GetDeviceCaps, CreateDevice, Reset, CreateAdditionalSwapChain, GetSwapChain, and GetNumberOfSwapchains.

Core usage scenarios include rendering to each head, and cursor manipulation.

For each of the covered interface methods, a set of test cases are run to verify the basic functional properties. Most of these tests simply involve verifying state changes or verifying that the actual results match the expected results. There are several tests that vary the surface properties of each head, render a scene on the heads, and compare the images against the rendering of the reference device.

Command syntax

Command option Description

Multihead.exe -dx9 -whql -logclean

Runs the MultiHead Support test job.

Multihead.exe -whql -logclean

Runs the MultiHead Support (WoW64) test job.

 

Note  

For command line help for this test binary, type /h.

 

File list

File Location

Configdisplay.exe

<[testbinroot]>\nttest\windowstest\tools\

D3d10ref.dll

<[testbinroot]>\nttest\graphics\d3d\support\

D3d11ref.dll

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

D3dcompiler_test.dll

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

D3dref.dll

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

D3dref8.dll

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

D3dref9.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\

D3dx8d.dll

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

D3dx9_TEST.dll

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

Fpstate.dll

<[testbinroot]>\nttest\windowstest\graphics\d3d\utility\

Modechange.exe

<[testbinroot]>\nttest\windowstest\graphics\d3d\utility\

Multihead.exe

<[testbinroot]>\nttest\

TDRWatch.exe

<[testbinroot]>\nttest\windowstest\graphics\

Vbswap.x

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

 

 

 

Send comments about this topic to Microsoft