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