Edit

Share via

D3D12_NODE_MASK structure (d3d12.h)

  • Article

A state subobject that identifies the GPU nodes to which the state object applies.

Syntax

typedef struct D3D12_NODE_MASK {
  UINT NodeMask;
} D3D12_NODE_MASK;

Members

NodeMask

The node mask.

Remarks

This subobject is optional. In its absence, the state object applies to all available nodes. If a node mask subobject has been associated with any part of a state object, a node mask association must be made to all exports in a state object (including imported collections) and all node mask subobjects that are referenced must have matching content.

Important

On some versions of the DirectX Runtime, specifying a node via D3D12_NODE_MASK in a D3D12_STATE_SUBOBJECT with type D3D12_STATE_SUBOBJECT_TYPE_NODE_MASK, the runtime will incorrectly handle a node mask value of 0, which should use node #1, which will lead to errors when attempting to use the state object later. Specify an explicit node value of 1, or omit the D3D12_NODE_MASK subobject to avoid this issue.

Requirements

Requirement Value
Header d3d12.h