ID3D11DeviceContextX::SetDrawBalancing Method

Configures how the GPU front-end distributes work across the four shader engines on Xbox One X hardware.

Syntax

public:
void SetDrawBalancing(
         UINT BalanceMode,
         UINT Flags
)

Parameters

BalanceMode
Type: UINT

[in] Specifies the way in which work is distributed. Valid values are defined by the D3D11X_SET_DRAW_BALANCING_MODE enumeration.

Flags
Type: UINT

[in] Reserved. Set to 0.

Return value

None.

Remarks

Draw balancing is a hardware feature that analyzes draw calls inside the work distributor (WD) of the Xbox One X GPU and changes the alternation rates to spread them more evenly across the four shader engines, thereby increasing performance. Draw balancing is automatic for Direct3D 12.x titles when conditions of the draw call permit it, but Direct3D 11.x titles must opt-in and guarantee correctness of the result.

SetDrawBalancing is only meaningful on Xbox One X hardware and is incompatible with the following:

Primitive restart index is automatically turned off when SetDrawBalancing is called with non-zero arguments.
Draw balancing is automatically disabled for the hardware topology types DI_PT_POLYGON, DI_PT_LINELOOP, DI_PT_TRIFAN, and DI_PT_TRISTRIP_ADJ.

Requirements

Header: Declared in d3d11_x.h.

Library: Use d3d11_x.lib.