imm_atomic_iadd (sm5 - asm)

立即不可部分完成的整數會新增至記憶體。 傳回在加入之前記憶體中的值。

imm_atomic_iadd dst0[.single_component_mask], dst1, dstAddress[.swizzle], src0[.select_component]
項目 描述
dst0
[in]在寫入之前,包含 dst1 中的值。
dst1
此值必須是未排序的存取檢視, (UAV) (u#) 。 在計算著色器中,它也可以是執行緒群組共用記憶體 (g#) 。
dstAddress
[in]記憶體 naddress。
src0
[in]要加入至 dst1的值。

備註

此指令會針對每個元件位址 dstAddress 執行運算元 src0 的單一元件 32 位整數加入,其中 dst1 位為 dstAddress。 不區分簽署。

如果 dst1 是 u#,它可能已宣告為未經處理、具型別或結構化。 如果輸入,則必須將它宣告為 UINT/SINT,且系結的資源格式為 R32_UINT/_SINT。

如果 dst1 是 g#,則必須將其宣告為未經處理或結構化。

將加法傳回至 dst0之前,dst1記憶體中的值。

取自位址的元件數目取決於 dst1的維度。

整個作業會以不可部分完成的方式執行。

如果著色器調用處于非作用中狀態,例如,如果圖元稍早在執行中被捨棄,或圖元/樣本調用只存在做為衍生專案實際圖元/樣本的協助程式,則此指令完全不會改變 dst1 記憶體,而且未定義傳回的值。

u# 上的超出範圍定址會導致不寫入記憶體,除非 u# 是結構化的,而且位元組位移 (到位址) 的第二個元件結構) 造成超出界限存取,否則 UAV 的整個內容會變成未定義。

u# 或 g# 上的界限外定址會導致未定義的結果傳回 dst0中的著色器。

本指示適用于下列著色器階段:

頂點 船體 網域 幾何形狀 像素 計算
X X

由於 Direct3D 11.1 的所有著色器階段都提供 UAV,因此本指示適用于 Direct3D 11.1 執行時間的所有著色器階段,從 Windows 8 開始提供。

頂點 船體 網域 幾何形狀 像素 計算
X X X X X X

最小著色器模型

下列著色器模型中支援此指示:

著色器模型 支援
著色器模型 5
著色器模型 4.1
著色器模型 4
著色器模型 3 (DirectX HLSL)
著色器模型 2 (DirectX HLSL)
著色器模型 1 (DirectX HLSL)

著色器模型 5 元件 (DirectX HLSL)