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

# Write32BitValueBottomOfPipeX (XBOX One 系列)

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

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

## 語法

```cpp theme={null}
void Write32BitValueBottomOfPipeX(  
         D3D12_GPU_VIRTUAL_ADDRESS Destination,  
         UINT Value,  
         D3D12XBOX_FLUSH Flush,  
         D3D12XBOX_WRITE_VALUE_BOP_FLAGS Flags  
)  
```

### 參數

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

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

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

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

*Flush*   \_In\_\
類型：[D3D12XBOX\_FLUSH](/zh-TW/reference/graphics/d3d12_x/enums/d3d12xbox_flush)

**D3D12XBOX\_FLUSH** 列舉常數，用於搭配寫入作業使紋理快取失效。旗標必須是下列其中一項：

* **D3D12XBOX\_FLUSH\_BOP\_TEXTURE\_L1\_INVALIDATE**
* **D3D12XBOX\_FLUSH\_BOP\_TEXTURE\_L1\_VOLATILE**
* **D3D12XBOX\_FLUSH\_BOP\_TEXTURE\_L2\_INVALIDATE**
* **D3D12XBOX\_FLUSH\_BOP\_TEXTURE\_L2\_VOLATILE**
* **D3D12XBOX\_FLUSH\_BOP\_TEXTURE\_L2\_WRITEBACK**

*Flags*   \_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 位元時間戳記回寫，且僅支援搭配 [Write64BitValueBottomOfPipeX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_write64bitvaluebottomofpipex) 使用。

### 傳回值

類型：void

## 備註

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

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

## 需求

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

**程式庫：** d3d12\_x.lib

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

## 另請參閱

[ID3D12GraphicsCommandList](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/id3d12graphicscommandlist)\
[Write64BitValueBottomOfPipeX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_write64bitvaluebottomofpipex)


## Related topics

- [GetXmaFrameBitPosition](/zh-TW/reference/audio/xma2defs/functions/getxmaframebitposition.md)
- [GetXmaFrameLengthInBits](/zh-TW/reference/audio/xma2defs/functions/getxmaframelengthinbits.md)
- [GetLastXmaFrameBitPosition](/zh-TW/reference/audio/xma2defs/functions/getlastxmaframebitposition.md)
- [SetGraphicsRoot32BitConstant](/zh-TW/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setgraphicsroot32bitconstant_public.md)
- [SetGraphicsRoot32BitConstants](/zh-TW/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setgraphicsroot32bitconstants_public.md)