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

# AddToStateObject (XBOX Series 主機)

> 以累加方式新增至現有的狀態物件。

以累加方式新增至現有的狀態物件。相較於從頭建立一個屬於現有狀態物件超集的狀態物件 (例如再新增幾個著色器)，這樣做的 CPU 額外負荷較低。

## 語法

```cpp theme={null}
HRESULT AddToStateObject(  
         const D3D12_STATE_OBJECT_DESC* pAddition,  
         ID3D12StateObject* pStateObjectToGrowFrom,  
         REFIID riid,  
         void** ppNewStateObject  
)  
```

### 參數

*pAddition*   \_In\_\
類型：D3D12\_STATE\_OBJECT\_DESC\*

要新增至現有狀態物件之狀態物件內容的描述。

*pStateObjectToGrowFrom*   \_In\_\
類型：ID3D12StateObject\*

現有的狀態物件，在此作業期間可處於使用中 (例如，正在進行光線追蹤)。

*riid*   \_In\_\
類型：REFIID

必須是 `ID3D12StateObject` 介面的 IID。

*ppNewStateObject*   \_COM\_Outptr\_\
類型：void\*\*

傳回的狀態物件。

### 傳回值

類型：HRESULT

如果成功，會傳回 S\_OK；否則會傳回錯誤碼。如需錯誤碼清單，請參閱 [Direct3D 12 傳回碼](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues)。

## 需求

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

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

## 另請參閱

[ID3D12Device7](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12Device7/id3d12device7)


## Related topics

- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
- [XBOX Series X|S 總覽](/zh-TW/paths/series-xs/overview.md)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [SetPipelineState1 (XBOX Series consoles)](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_setpipelinestate1_public.md)
- [XBOX 主機遊戲的認證測試 XBOX 需求](/zh-TW/publishing/certification/console-cert-tested-requirements.md)