> ## 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_HEAP_FLAGS (XBOX One 系列)

> 指定堆積選項，例如堆積是否可包含紋理，以及資源是否跨介面卡共用。

指定堆積選項，例如堆積是否可包含紋理，以及資源是否跨介面卡共用。

## 語法

```cpp theme={null}
typedef enum D3D12_HEAP_FLAGS
{  
    D3D12_HEAP_FLAG_NONE = 0x0,  
    D3D12_HEAP_FLAG_SHARED = 0x1,  
    D3D12XBOX_HEAP_FLAG_ALLOW_INDIRECT_BUFFERS = 0x2,  
    D3D12_HEAP_FLAG_DENY_BUFFERS = 0x4,  
    D3D12_HEAP_FLAG_ALLOW_DISPLAY = 0x8,  
    D3D12_HEAP_FLAG_SHARED_CROSS_ADAPTER = 0x20,  
    D3D12_HEAP_FLAG_DENY_RT_DS_TEXTURES = 0x40,  
    D3D12_HEAP_FLAG_DENY_NON_RT_DS_TEXTURES = 0x80,  
    D3D12_HEAP_FLAG_HARDWARE_PROTECTED = 0x100,  
    D3D12_HEAP_FLAG_ALLOW_WRITE_WATCH = 0x200,  
    D3D12_HEAP_FLAG_ALLOW_ALL_BUFFERS_AND_TEXTURES = 0x0,  
    D3D12_HEAP_FLAG_ALLOW_ONLY_BUFFERS = 0xC0,  
    D3D12_HEAP_FLAG_ALLOW_ONLY_NON_RT_DS_TEXTURES = 0x44,  
    D3D12_HEAP_FLAG_ALLOW_ONLY_RT_DS_TEXTURES = 0x84,  
} D3D12_HEAP_FLAGS  
```

## 常數

| 常數 | 描述 |
| - | - |
| D3D12\_HEAP\_FLAG\_NONE | 未指定任何選項。 |
| D3D12\_HEAP\_FLAG\_SHARED | 堆積為共用。如需詳細資訊，請參閱[共用堆積](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/shared-heaps)。 |
| D3D12XBOX\_HEAP\_FLAG\_ALLOW\_INDIRECT\_BUFFERS | 允許堆積儲存間接緩衝區。 |
| D3D12\_HEAP\_FLAG\_DENY\_BUFFERS | 不允許堆積包含緩衝區。 |
| D3D12\_HEAP\_FLAG\_ALLOW\_DISPLAY | 允許堆積包含交換鏈結表面。 |
| D3D12\_HEAP\_FLAG\_SHARED\_CROSS\_ADAPTER | 允許堆積跨介面卡共用資源。如需詳細資訊，請參閱[共用堆積](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/shared-heaps)。 |
| D3D12\_HEAP\_FLAG\_DENY\_RT\_DS\_TEXTURES | 不允許堆積儲存轉譯目標 (RT) 或深度樣板 (DS) 紋理。 |
| D3D12\_HEAP\_FLAG\_DENY\_NON\_RT\_DS\_TEXTURES | 不允許堆積包含具有 **D3D12\_RESOURCE\_DIMENSION\_TEXTURE1D**、**D3D12\_RESOURCE\_DIMENSION\_TEXTURE2D** 或 **D3D12\_RESOURCE\_DIMENSION\_TEXTURE3D** 的資源，除非存在 **D3D12\_RESOURCE\_FLAG\_ALLOW\_RENDER\_TARGET** 或 **D3D12\_RESOURCE\_FLAG\_ALLOW\_DEPTH\_STENCIL**。如需詳細資訊，請參閱 [D3D12\_RESOURCE\_DIMENSION](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ne-d3d12-d3d12_resource_dimension) 和 [D3D12\_RESOURCE\_FLAGS](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ne-d3d12-d3d12_resource_flags)。 |
| D3D12\_HEAP\_FLAG\_HARDWARE\_PROTECTED | 不支援。請勿使用。 |
| D3D12\_HEAP\_FLAG\_ALLOW\_WRITE\_WATCH | 堆積支援 **MEM\_WRITE\_WATCH** 功能，這會使系統追蹤已認可記憶體區域中被寫入的頁面。此旗標無法與 **D3D12\_HEAP\_TYPE\_DEFAULT** 或 **D3D12\_CPU\_PAGE\_PROPERTY\_UNKNOWN** 旗標結合使用。不建議遊戲使用此旗標，因為它會讓工具無法使用 **MEM\_WRITE\_WATCH** 功能。 |
| D3D12\_HEAP\_FLAG\_ALLOW\_ALL\_BUFFERS\_AND\_TEXTURES | 允許堆積儲存所有類型的緩衝區和紋理。這是別名；如需詳細資訊，請參閱 [D3D12\_HEAP\_FLAGS](https://msdn.microsoft.com/library/windows/desktop/dn986730\(v=vs.85\).aspx) 備註一節中的「別名」。 |
| D3D12\_HEAP\_FLAG\_ALLOW\_ONLY\_BUFFERS | 只允許堆積儲存緩衝區。這是別名；如需詳細資訊，請參閱 [D3D12\_HEAP\_FLAGS](https://msdn.microsoft.com/library/windows/desktop/dn986730\(v=vs.85\).aspx) 備註一節中的「別名」。 |
| D3D12\_HEAP\_FLAG\_ALLOW\_ONLY\_NON\_RT\_DS\_TEXTURES | 只允許堆積儲存非 RT 和非 DS 的紋理。這是別名；如需詳細資訊，請參閱 [D3D12\_HEAP\_FLAGS](https://msdn.microsoft.com/library/windows/desktop/dn986730\(v=vs.85\).aspx) 備註一節中的「別名」。 |
| D3D12\_HEAP\_FLAG\_ALLOW\_ONLY\_RT\_DS\_TEXTURES | 只允許堆積儲存 RT 和/或 DS 紋理。這是別名；如需詳細資訊，請參閱 [D3D12\_HEAP\_FLAGS](https://msdn.microsoft.com/library/windows/desktop/dn986730\(v=vs.85\).aspx) 備註一節中的「別名」。 |

## 備註

適用於 XBOX One 的 Microsoft Game Development Kit (GDK) 在此列舉中定義了 **D3D12XBOX\_HEAP\_FLAG\_ALLOW\_INDIRECT\_BUFFERS** 延伸成員。如需此列舉的非 XBOX 特定版本，請參閱 [D3D12\_HEAP\_FLAGS](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ne-d3d12-d3d12_heap_flags)。

如需堆積旗標的詳細資訊，請參閱 **D3D12\_HEAP\_FLAGS** 的備註一節。

## 需求

**標頭：** d3d12\_x.h

**支援的平台：** XBOX One 系列

## 另請參閱

[d3d12\_x](/zh-TW/reference/graphics/d3d12_x/d3d12_x_members)\
[共用堆積](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/shared-heaps)\
[D3D12\_HEAP\_TYPE](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ne-d3d12-d3d12_heap_type)


## Related topics

- [GetHeapProperties](/reference/graphics/d3d12/interfaces/id3d12resource/methods/id3d12resource_getheapproperties_public.md)
- [D3D12_RESOURCE_HEAP_TIER](/reference/graphics/d3d12/enums/d3d12_resource_heap_tier_public.md)
- [D3D12_FORMAT_SUPPORT1](/reference/graphics/d3d12/enums/d3d12_format_support1_public.md)
