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

# Write32BitValueBottomOfPipe2X (XBOX Series 主機)

> 從管線底部將 32 位元值寫入記憶體中的指定目的地。

從管線底部將 32 位元值寫入記憶體中的指定目的地。

## 語法

```cpp theme={null}
void Write32BitValueBottomOfPipe2X(  
         D3D12_GPU_VIRTUAL_ADDRESS Destination,  
         UINT Value,  
         D3D12XBOX_SYNC_FLAGS SyncFlags,  
         D3D12XBOX_SYNC_CONTROL_FLAGS ControlFlags,  
         D3D12XBOX_WRITE_VALUE_BOP_FLAGS WriteFlags  
)  
```

### 參數

*Destination*   \_In\_\
類型：[D3D12\_GPU\_VIRTUAL\_ADDRESS](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12_gpu_virtual_address)

要寫入值的圖形記憶體基底位址。位址必須以 4 位元組對齊。

*Value*   \_In\_\
類型：UINT

要寫入指定記憶體位置的 32 位元值。

*SyncFlags*   \_In\_\
類型：[D3D12XBOX\_SYNC\_FLAGS](/zh-TW/reference/graphics/d3d12_xs/enums/d3d12xbox_sync_flags)

與寫入作業一起執行的一組選用同步指示詞。旗標可以是下列項目的組合：

* **D3D12XBOX\_SYNC\_FLAG\_VCACHE\_INVALIDATE**
* **D3D12XBOX\_SYNC\_FLAG\_MCACHE\_INVALIDATE**
* **D3D12XBOX\_SYNC\_FLAG\_MCACHE\_WRITEBACK**
* **D3D12XBOX\_SYNC\_FLAG\_GL1\_INVALIDATE**
* **D3D12XBOX\_SYNC\_FLAG\_GL2\_INVALIDATE**
* **D3D12XBOX\_SYNC\_FLAG\_GL2\_WRITEBACK**
* **D3D12XBOX\_SYNC\_FLAG\_GL2\_VOLATILE**

*ControlFlags*   \_In\_\
類型：[D3D12XBOX\_SYNC\_CONTROL\_FLAGS](/zh-TW/reference/graphics/d3d12_xs/enums/d3d12xbox_sync_control_flags)

要套用於同步作業的一組選用控制修飾詞。旗標可以是下列其中一項：

* **D3D12XBOX\_SYNC\_CONTROL\_FLAG\_GCR\_SEQUENCE\_FORWARD**
* **D3D12XBOX\_SYNC\_CONTROL\_FLAG\_GCR\_SEQUENCE\_REVERSE**

*WriteFlags*   \_In\_\
類型：[D3D12XBOX\_WRITE\_VALUE\_BOP\_FLAGS](/zh-TW/reference/graphics/d3d12_x/enums/d3d12xbox_write_value_bop_flags)

*D3D12XBOX\_WRITE\_VALUE\_BOP\_FLAGS* 的位元 OR 組合，用於控制寫入作業。目前必須設為 *D3D12XBOX\_WRITE\_VALUE\_BOP\_FLAG\_NONE*。*D3D12XBOX\_WRITE\_VALUE\_BOP\_FLAG\_GPU\_TIMESTAMP* 和 *D3D12XBOX\_WRITE\_VALUE\_BOP\_FLAG\_SYSTEM\_TIMESTAMP* 旗標會要求 64 位元時間戳記回寫，且僅受 [Write64BitValueBottomOfPipe2X](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/methods/id3d12graphicscommandlist6_write64bitvaluebottomofpipe2x) 支援。

### 傳回值

類型：void

無。

## 備註

32 位元值會在所有著色器執行與轉譯後端處理完成後寫入記憶體，但可能會在先前繪製與分派所產生的所有記憶體寫入完成之前寫入。

搭配 [Wait32BitValueX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_wait32bitvaluex) 方法使用時，*Write32BitValueBottomOfPipe2X* 可作為實用的跨引擎、命令清單內同步機制。

## 需求

**標頭：** d3d12\_xs.h\
**程式庫：** d3d12\_xs.lib\
**支援的平台：** XBOX Series 主機

## 另請參閱

[ID3D12GraphicsCommandList6](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/id3d12graphicscommandlist6)\
[d3d12\_xs](/zh-TW/reference/graphics/d3d12_xs/d3d12_xs_members)


## Related topics

- [D3D12_RAYTRACING_INSTANCE_DESC (XBOX Series consoles)](/reference/graphics/d3d12/structs/d3d12_raytracing_instance_desc_public.md)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_SERIALIZATION_DESC (XBOX Series consoles)](/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_serialization_desc_public.md)
- [XBOX Series X|S 總覽](/zh-TW/paths/series-xs/overview.md)
- [RSSetShadingRateImage (XBOX Series consoles)](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist5/methods/id3d12graphicscommandlist5_rssetshadingrateimage_public.md)