> ## 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 manière incrémentielle des éléments à un objet d'état existant.

Ajoute de manière 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 serait un sur-ensemble d'un objet existant (par exemple, pour ajouter 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/reference/graphics/d3d12_xs/interfaces/ID3D12Device7/id3d12device7)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr/nda/nda-topic-directory.md)
- [SetPipelineState1 (consoles XBOX Series)](/fr/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_setpipelinestate1_public.md)
- [GetShaderIdentifier (consoles XBOX Series)](/fr/reference/graphics/d3d12/interfaces/id3d12stateobjectproperties/methods/id3d12stateobjectproperties_getshaderidentifier_public.md)
- [D3D12_STATE_OBJECT_CONFIG](/fr/reference/graphics/d3d12/structs/d3d12_state_object_config_public.md)
- [D3D12_STATE_OBJECT_FLAGS](/fr/reference/graphics/d3d12/enums/d3d12_state_object_flags_public.md)