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

# LoadPipeline

> Recupera o PSO solicitado da biblioteca. A descrição do fluxo de pipeline é comparada com o banco de dados da biblioteca e memorizada para evitar.

Recupera o PSO solicitado da biblioteca. A descrição do fluxo de pipeline é comparada com o banco de dados da biblioteca e memorizada para evitar a duplicação do conteúdo do PSO.

## Sintaxe

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

### Parâmetros

*pName \[in]*\
Tipo: LPCWSTR

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

O nome exclusivo do PSO.

*pDesc \[in]*\
Tipo: const D3D12\_PIPELINE\_STATE\_STREAM\_DESC \*

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

Descreve o PSO necessário usando uma estrutura [D3D12\_PIPELINE\_STATE\_STREAM\_DESC](/pt-BR/reference/graphics/d3d12/structs/d3d12_pipeline_state_stream_desc_public). Essa descrição é comparada com o banco de dados da biblioteca e armazenada para evitar a duplicação do conteúdo do PSO.

*riid*\
Tipo: const IID &

Especifica um REFIID para o objeto ID3D12PipelineStateState.

Normalmente, os aplicativos devem definir este argumento e o argumento seguinte, ppPipelineState, usando a macro IID\_PPV\_ARGS(\&PSO1), em que PSO1 é o nome do objeto.

*ppPipelineState \[out]*\
Tipo: void \*\*

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

Especifica o ponteiro que fará referência ao PSO depois que a função retornar com sucesso.

### Valor retornado

Tipo: HRESULT

Este método retorna um código HRESULT de sucesso ou erro, que pode incluir E\_INVALIDARG se o nome não existir ou se a descrição do fluxo não corresponder aos dados na biblioteca, e E\_OUTOFMEMORY se a função não conseguir alocar o PSO resultante.

## 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 substitui as funções [ID3D12PipelineLibrary::LoadGraphicsPipeline](/pt-BR/reference/graphics/d3d12/interfaces/id3d12pipelinelibrary/methods/id3d12pipelinelibrary_loadgraphicspipeline_public) e [ID3D12PipelineLibrary::LoadComputePipeline](/pt-BR/reference/graphics/d3d12/interfaces/id3d12pipelinelibrary/methods/id3d12pipelinelibrary_loadcomputepipeline_public), que recebem a descrição do 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.

## Requisitos

**Cabeçalho:** d3d12\_xs.h ou d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib ou d3d12\_x.lib\
**Plataformas compatíveis**: 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.

[ID3D12PipelineLibrary1](/pt-BR/reference/graphics/d3d12/interfaces/id3d12pipelinelibrary1/id3d12pipelinelibrary1_public)


## Related topics

- [CreatePipelineLibrary](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device1/methods/id3d12device1_createpipelinelibrary_public.md)
- [LoadComputePipeline](/pt-BR/reference/graphics/d3d12/interfaces/id3d12pipelinelibrary/methods/id3d12pipelinelibrary_loadcomputepipeline_public.md)
- [LoadGraphicsPipeline](/pt-BR/reference/graphics/d3d12/interfaces/id3d12pipelinelibrary/methods/id3d12pipelinelibrary_loadgraphicspipeline_public.md)
- [ACP_COMMAND_LOAD_SHAPE_FLOWGRAPH](/pt-BR/reference/audio/acphal/structs/acp_command_load_shape_flowgraph.md)
- [StorePipeline](/pt-BR/reference/graphics/d3d12/interfaces/id3d12pipelinelibrary/methods/id3d12pipelinelibrary_storepipeline_public.md)