MultiHead Support (WoW64)

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

   
Specifications
  • Device.Graphics.AdapterRender.MinimumDirectXLevel
Platforms
  • Windows 10, client editions (x64)
  • Windows Server 2016 (x64)
  • Windows 10, client editions (Arm64)
Supported Releases
  • Windows 10
  • Windows 10, version 1511
  • Windows 10, version 1607
  • Windows 10, version 1703
  • Windows 10, version 1709
  • Windows 10, version 1803
  • Windows 10, version 1809
  • Windows 10, version 1903
  • Next update to Windows 10
Expected run time (in minutes) 20
Category Compatibility
Timeout (in minutes) 1200
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 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 generic troubleshooting of HLK test failures, see Troubleshooting Windows HLK Test Failures.

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\

 

Parameters

Parameter name Parameter description
MONITOR Index of display output to target with test
MODIFIEDCMDLINE Additional command line arguments for test executable
LLU_NetAccessOnly LLU Name of net user
ConfigDisplayCommandLine Custom Command Line for ConfigDisplay. Default: logo
TDRArgs /get or /set