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

# PrefetchPipelineStateX (consoles XBOX Series)

> PrefetchPipelineStateX (consoles XBOX Series) — Faz a pré-busca do estado de pipeline especificado. Referência da API gráfica Direct3D 12 para desenvolvimento de jogos para XBOX.

Faz a pré-busca dos binários de programas de shader contidos no estado de pipeline especificado para o cache de nível 2 de gráficos.

## Sintaxe

```cpp theme={null}
void PrefetchPipelineStateX(  
         ID3D12PipelineState* pPipelineState,  
         UINT64 ShaderPrefetchSizeBytes,  
         D3D12XBOX_PREFETCH_PIPELINE_STATE_FLAGS PipelineStateFlags,  
         D3D12XBOX_PREFETCH_MEMORY_FLAGS Flags  
)  
```

### Parâmetros

*pPipelineState*   \_In\_\
Tipo: ID3D12PipelineState\*

O objeto de estado de pipeline a ser buscado.

*ShaderPrefetchSizeBytes*   \_In\_\
Tipo: UINT64

A quantidade de memória, em bytes, a ser pré-buscada a partir do início de cada programa de shader selecionado no objeto de estado de pipeline.

*PipelineStateFlags*   \_In\_\
Tipo: [D3D12XBOX\_PREFETCH\_PIPELINE\_STATE\_FLAGS](/pt-BR/reference/graphics/d3d12_x/enums/d3d12xbox_prefetch_pipeline_state_flags)

Sinalizadores que selecionam quais programas de shader no objeto de estado de pipeline devem ser pré-buscados.

*Flags*   \_In\_\
Tipo: [D3D12XBOX\_PREFETCH\_MEMORY\_FLAGS](/pt-BR/reference/graphics/d3d12_x/enums/d3d12xbox_prefetch_memory_flags)

Sinalizadores que controlam a natureza da operação de pré-busca.

### Valor retornado

Tipo: void

Nenhum.

## Comentários

A implementação de PrefetchPipelineStateX efetivamente chama a API [PrefetchMemoryX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_prefetchmemoryx) uma vez para cada programa de shader selecionado no objeto de estado de pipeline, usando o endereço base do programa de shader e o tamanho especificado pelo parâmetro ShaderPrefetchSizeBytes.

## Requisitos

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

**Biblioteca:** d3d12\_xs.lib\
**Plataformas compatíveis**: consoles XBOX Series

## Confira também

[ID3D12GraphicsCommandList6](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/id3d12graphicscommandlist6)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [SetPipelineState1 (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_setpipelinestate1_public.md)
- [GetPipelineStackSize (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12stateobjectproperties/methods/id3d12stateobjectproperties_getpipelinestacksize_public.md)
- [SetPipelineStackSize (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12stateobjectproperties/methods/id3d12stateobjectproperties_setpipelinestacksize_public.md)
- [D3D12_RAYTRACING_PIPELINE_CONFIG (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/structs/d3d12_raytracing_pipeline_config_public.md)