Multihead

Multihead cards are those that have a common frame buffer and accelerator, independent digital-to-analog converters (DACs), and monitor outputs. Such devices can offer much more usable multiple monitor support than a similar number of heterogeneous display adapters.

Multihead cards are exposed in the application programming interface (API) as a single API-level device that can drive several full-screen swap chains. Consequently, all resources are shared with all the heads, and each head has exactly the same capabilities. Each head can be set to independent display modes and can be refreshed (with IDirect3DSwapChain9::Present) at different times. Use IDirect3DDevice9::Present for simultaneous presents.

Each swap chain for a multihead device must be full screen. When a device has entered multihead mode, it must remain full screen. The transition back to windowed mode requires the destruction of the device (except for the normal ALT+TAB-to-minimize operation).

The old method of dividing video memory between the heads and treating each head as a fully independent accelerator will still be a common usage scenario. This proposal does not replace that mechanism unless the application has been specifically coded to function in the Microsoft?DirectX?9.0 multihead mode.

Drivers are given adequate knowledge to switch between the two modes of operation.

One head will be called the "master" head, and all other heads on the same card be called "subordinate" heads. If more than one multihead adapter is present in a system, the master and its subordinates from one multihead adapter are called a "group." Groups are denoted by the adapter ordinal of their master head.

The D3DCAPS9 structure will be updated to expose the following new hardware caps.

UINT NumberOfAdaptersInGroup; 
UINT MasterAdapterOrdinal; 
UINT AdapterOrdinalInGroup;

• NumberOfAdaptersInGroup is 1 for conventional adapters, and greater than 1 for the master adapter of a multihead card. The value will be 0 for a subordinate adapter of a multihead card. Each card can have at most one master, but might have many subordinates.
• MasterAdapterOrdinal indicates which device is the master for this subordinate.
• AdapterOrdinalInGroup indicates the order in which heads are referenced by the API. The master adapter always has AdapterOrdinalInGroup 0. These values do not correspond to the adapter ordinals passed to the IDirect3D9 methods, but apply only to heads within a group.

This definition allows multihead cards to continue to present multiple adapters as if they were independent cards, just as they did in DirectX 8.x.

To create a multihead device, specify the behavior flag D3DCREATE_ADAPTERGROUP_DEVICE in IDirect3D9::CreateDevice. The presentation parameters (an array of D3DPRESENT_PARAMETERS) should contain NumberOfAdaptersInGroup elements. The runtime will assign each element to each head in AdapterOrdinalInGroup numerical order. When D3DCREATE_ADAPTERGROUP_DEVICE is set, each presentation parameter must have:

• Windowed set to FALSE (in other words, be full screen).
• The same value for the EnableAutoDepthStencil member of D3DPRESENT_PARAMETERS.

In addition, if EnableAutoDepthStencil is TRUE, then each of the following fields must have the same value for each D3DPRESENT_PARAMETERS:

• AutoDepthStencilFormat
• BackBufferWidth
• BackBufferHeight
• BackBufferFormat

If D3DCREATE_ADAPTERGROUP_DEVICE is set, additional calls to IDirect3DDevice9::CreateAdditionalSwapChain are illegal.

If the device was created with the D3DCREATE_ADAPTERGROUP_DEVICE, IDirect3DDevice9::Reset will expect an array of D3DPRESENT_PARAMETERS.

Each D3DPRESENT_PARAMETERS passed to IDirect3DDevice9::Reset must be full screen. To switch back to windowed mode, the application must destroy the device and re-create a non-multihead device in windowed mode.

Here is a basic usage scenario.

1. Create Device multihead.
2. For each swap chain of device:
   3. Call GetBackBuffer for the i-th swapchain.
   4. Call SetRenderTarget. 
   5. Call DrawPrimitive. 
   6. Optionally call swapchain::Present (or wait until 
      all swap chains are drawn and present outside of loop).
7. End for.
8. Optionally present all swap chains with device::Present.

For more information, see IDirect3D9::CreateDevice and IDirect3DDevice9::GetNumberOfSwapChains.