> ## 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 (consoles XBOX Series)

> Ajoute de façon incrémentielle des éléments à un objet d'état existant.

Ajoute de façon incrémentielle des éléments à un objet d'état existant. Cette opération entraîne une surcharge CPU inférieure à celle de la création à partir de zéro d'un objet d'état qui est un sur-ensemble d'un objet existant (par exemple, l'ajout de quelques nuanceurs supplémentaires).

## Syntaxe

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

### Paramètres

*pAddition*   \_In\_\
Type : D3D12\_STATE\_OBJECT\_DESC\*

Description du contenu de l'objet d'état à ajouter à l'objet d'état existant.

*pStateObjectToGrowFrom*   \_In\_\
Type : ID3D12StateObject\*

Objet d'état existant, qui peut être en cours d'utilisation (par exemple, lancer de rayons actif) pendant cette opération.

*riid*   \_In\_\
Type : REFIID

Doit être l'IID de l'interface `ID3D12StateObject`.

*ppNewStateObject*   \_COM\_Outptr\_\
Type : void\*\*

Objet d'état retourné.

### Valeur de retour

Type : HRESULT

Retourne S\_OK en cas de réussite; sinon, retourne un code d'erreur. Pour obtenir la liste des codes d'erreur, consultez [Codes de retour Direct3D 12](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues).

## Configuration requise

**En-tête :** d3d12\_xs.h

**Bibliothèque :** d3d12\_xs.lib\
**Plateformes prises en charge :** consoles XBOX Series

## Voir aussi

[ID3D12Device7](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12Device7/id3d12device7)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [SetPipelineState1 (XBOX Series consoles)](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_setpipelinestate1_public.md)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [GetShaderIdentifier (XBOX Series consoles)](/reference/graphics/d3d12/interfaces/id3d12stateobjectproperties/methods/id3d12stateobjectproperties_getshaderidentifier_public.md)