> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# D3D12_NODE_MASK

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

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

## Syntax

```cpp theme={null}
typedef struct D3D12_NODE_MASK
{
    UINT NodeMask;
} D3D12_NODE_MASK
```

### 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.

<Info>
  On some versions of the DirectX Runtime, specifying a node via **D3D12\_NODE\_MASK** in a [**D3D12\_STATE\_SUBOBJECT**](/reference/graphics/d3d12/structs/d3d12_state_subobject_public) with type [**D3D12\_STATE\_SUBOBJECT\_TYPE\_NODE\_MASK**](/reference/graphics/d3d12_xs/enums/d3d12_state_subobject_type_xs), 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.
</Info>

## 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


## Related topics

- [D3D12_STATE_SUBOBJECT_TYPE](/reference/graphics/d3d12/enums/d3d12_state_subobject_type_public.md)
- [D3D12_PROTECTED_RESOURCE_SESSION_DESC](/reference/graphics/d3d12/structs/d3d12_protected_resource_session_desc_public.md)
- [D3D12_QUERY_HEAP_DESC](/reference/graphics/d3d12/structs/d3d12_query_heap_desc_public.md)
- [D3D12_PROTECTED_RESOURCE_SESSION_DESC1](/reference/graphics/d3d12/structs/d3d12_protected_resource_session_desc1_public.md)
- [D3D12_COMMAND_QUEUE_DESC](/reference/graphics/d3d12/structs/d3d12_command_queue_desc_public.md)