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

> Adiciona incrementalmente a um objeto de estado existente.

Adiciona incrementalmente a um objeto de estado existente. Isso gera menor sobrecarga de CPU do que criar do zero um objeto de estado que seja um superconjunto de um existente (por exemplo, adicionando mais alguns sombreadores).

## Sintaxe

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

### Parâmetros

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

Descrição do conteúdo do objeto de estado a ser adicionado ao objeto de estado existente.

*pStateObjectToGrowFrom*   \_In\_\
Tipo: ID3D12StateObject\*

Objeto de estado existente, que pode estar em uso (por exemplo, ray tracing ativo) durante esta operação.

*riid*   \_In\_\
Tipo: REFIID

Deve ser o IID da interface `ID3D12StateObject`.

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

Objeto de estado retornado.

### Valor retornado

Tipo: HRESULT

Retorna S\_OK se tiver êxito; caso contrário, retorna um código de erro. Para obter uma lista de códigos de erro, consulte [Códigos de retorno do Direct3D 12](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues).

## Requisitos

**Cabeçalho:** d3d12\_xs.h

**Biblioteca:** d3d12\_xs.lib\
**Plataformas com suporte**: consoles XBOX Series

## Confira também

[ID3D12Device7](/pt-BR/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)