> ## 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 (família XBOX One)

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

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

## 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, para pré-busca a partir do início de cada programa de sombreador 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 sombreador 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

## 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 sombreador selecionado no objeto de estado de pipeline, usando o endereço base do programa de sombreador e o tamanho especificado pelo parâmetro ShaderPrefetchSizeBytes.

## Requisitos

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

**Biblioteca:** d3d12\_x.lib ou d3d12\_xs.lib

**Plataformas compatíveis:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[PrefetchMemoryX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_prefetchmemoryx)

[ID3D12GraphicsCommandList](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/id3d12graphicscommandlist)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [SetPipelineState](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setpipelinestate_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_CACHED_PIPELINE_STATE](/pt-BR/reference/graphics/d3d12/structs/d3d12_cached_pipeline_state_public.md)