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

> 标识状态对象应用到的 GPU 节点的状态子对象。

标识状态对象应用到的 GPU 节点的状态子对象。

## 语法

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

### 成员

*NodeMask*\
类型：UINT

节点掩码。

## 备注

此子对象是可选的。若不存在，则状态对象应用于所有可用节点。如果节点掩码子对象已与状态对象的任何部分关联，则必须对状态对象中的所有导出（包括导入的集合）进行节点掩码关联，并且所有被引用的节点掩码子对象必须具有匹配的内容。

<Info>
  在某些版本的 DirectX 运行时中，在类型为 [**D3D12\_STATE\_SUBOBJECT\_TYPE\_NODE\_MASK**](/reference/graphics/d3d12_xs/enums/d3d12_state_subobject_type_xs) 的 [**D3D12\_STATE\_SUBOBJECT**](/reference/graphics/d3d12/structs/d3d12_state_subobject_public) 中通过 **D3D12\_NODE\_MASK** 指定节点时，运行时会错误地处理值为 `0` 的节点掩码（应使用节点 #1），这将导致以后尝试使用该状态对象时出错。请指定显式的节点值 1，或省略 **D3D12\_NODE\_MASK** 子对象以避免此问题。
</Info>

## 要求

**头文件：** d3d12\_xs.h 或 d3d12\_x.h\
**库：** d3d12\_xs.lib 或 d3d12\_x.lib\
**支持的平台**：XBOX Series 主机和 XBOX One 系列


## Related topics

- [D3D12_STATE_SUBOBJECT_TYPE](/zh-CN/reference/graphics/d3d12/enums/d3d12_state_subobject_type_public.md)
- [D3D12_QUERY_HEAP_DESC](/zh-CN/reference/graphics/d3d12/structs/d3d12_query_heap_desc_public.md)
- [D3D12_PROTECTED_RESOURCE_SESSION_DESC](/zh-CN/reference/graphics/d3d12/structs/d3d12_protected_resource_session_desc_public.md)
- [D3D12_CROSS_NODE_SHARING_TIER](/zh-CN/reference/graphics/d3d12/enums/d3d12_cross_node_sharing_tier_public.md)
- [D3D12_DRED_ALLOCATION_NODE](/zh-CN/reference/graphics/d3d12/structs/d3d12_dred_allocation_node_public.md)