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

# CreatePipelineState

> Cria um objeto de estado de pipeline a partir de uma descrição de fluxo de estado de pipeline.

Cria um objeto de estado de pipeline a partir de uma descrição de fluxo de estado de pipeline.

## Sintaxe

```cpp theme={null}
HRESULT CreatePipelineState(
    const D3D12_PIPELINE_STATE_STREAM_DESC  pDesc,
    const IID & riid,
    void  ppPipelineState
)
```

### Parâmetros

*pDesc*<br />Tipo: const D3D12\_PIPELINE\_STATE\_STREAM\_DESC \*

O endereço de uma estrutura [D3D12\_PIPELINE\_STATE\_STREAM\_DESC](/pt-BR/reference/graphics/d3d12/structs/d3d12_pipeline_state_stream_desc_public) que descreve o estado do pipeline.

*riid*<br />Tipo: const IID &

O identificador global exclusivo (**GUID**) da interface de estado de pipeline ([ID3D12PipelineState](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12PipelineState/id3d12pipelinestate_xs)).

O **REFIID**, ou **GUID**, da interface para o estado de pipeline pode ser obtido usando a macro \_\_uuidof(). Por exemplo, \_\_uuidof(ID3D12PipelineState) obterá o **GUID** da interface para um estado de pipeline.

*ppPipelineState \[out]*<br />Tipo: void \*\*

[SAL](https://learn.microsoft.com/en-us/cpp/code-quality/annotating-function-parameters-and-return-values): <code>*COM\_Outptr*</code>

Um ponteiro para um bloco de memória que recebe um ponteiro para a interface [ID3D12PipelineState](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12PipelineState/id3d12pipelinestate_xs) do objeto de estado de pipeline.

O objeto de estado de pipeline é um objeto de estado imutável. Ele não contém métodos.

### Valor retornado

Tipo: HRESULT

Este método retorna **E\_OUTOFMEMORY** se não houver memória suficiente para criar o objeto de estado de pipeline. Consulte [Códigos de retorno do Direct3D 12](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues) para outros valores retornados possíveis.

## Comentários

Esta função recebe a descrição do pipeline como um [D3D12\_PIPELINE\_STATE\_STREAM\_DESC](/pt-BR/reference/graphics/d3d12/structs/d3d12_pipeline_state_stream_desc_public) e combina a funcionalidade das funções [ID3D12Device::CreateGraphicsPipelineState](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_creategraphicspipelinestate_public) e [ID3D12Device::CreateComputePipelineState](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcomputepipelinestate_public), que recebem sua descrição de pipeline como as estruturas menos flexíveis [D3D12\_GRAPHICS\_PIPELINE\_STATE\_DESC](/pt-BR/reference/graphics/d3d12_x/structs/d3d12_graphics_pipeline_state_desc) e [D3D12\_COMPUTE\_PIPELINE\_STATE\_DESC](/pt-BR/reference/graphics/d3d12/structs/d3d12_compute_pipeline_state_desc_public), respectivamente.

<Note>
  AVISO: os sombreadores de amplificação nos consoles XBOX Series X|S têm problemas conhecidos de estabilidade e desempenho. A Microsoft não recomenda usá-los nos consoles XBOX Series X|S.
</Note>

## Requisitos

**Cabeçalho:** d3d12\_xs.h ou d3d12\_x.h<br />**Biblioteca:** d3d12\_xs.lib ou d3d12\_x.lib<br />**Plataformas com suporte**: consoles XBOX Series e família XBOX One

## Confira também

Consulte [D3D12\_PIPELINE\_STATE\_STREAM\_DESC](/pt-BR/reference/graphics/d3d12/structs/d3d12_pipeline_state_stream_desc_public) para obter uma descrição do layout e do comportamento de uma descrição de pipeline de streaming.

[ID3D12Device2](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device2/id3d12device2_public)


## Related topics

- [D3D12_PIPELINE_STATE_STREAM_DESC](/pt-BR/reference/graphics/d3d12/structs/d3d12_pipeline_state_stream_desc_public.md)
- [OMSetDepthBounds](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist1/methods/id3d12graphicscommandlist1_omsetdepthbounds_public.md)
- [CreateComputePipelineState](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcomputepipelinestate_public.md)
- [CreateGraphicsPipelineState](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_creategraphicspipelinestate_public.md)
- [D3D12_COMPUTE_PIPELINE_STATE_DESC](/pt-BR/reference/graphics/d3d12/structs/d3d12_compute_pipeline_state_desc_public.md)