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

​
Syntax

​
Members

NodeMask
Type: UINT 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.
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

Header: d3d12_xs.h or d3d12_x.h
Library: d3d12_xs.lib or d3d12_x.lib
Supported Platforms: XBOX Series consoles and XBOX One family
Last modified on August 20, 2026