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

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):

• Device.Graphics additional documentation

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

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

File list

Parameters