> ## 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 (famille XBOX One)

> PrefetchPipelineStateX (consoles de la famille XBOX One) — Effectue la prélecture de l'état de pipeline spécifié. Référence de l'API graphique Direct3D 12 pour le développement de jeux vidéo XBOX.

Effectue la prélecture des binaires de programmes de nuanceur contenus dans l'état de pipeline spécifié dans le cache graphique de niveau 2.

## Syntaxe

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

### Paramètres

*pPipelineState*   \_In\_\
Type : ID3D12PipelineState\*

L'objet d'état de pipeline à prélire.

*ShaderPrefetchSizeBytes*   \_In\_\
Type : UINT64

La quantité de mémoire, en octets, à prélire à partir du début de chaque programme de nuanceur sélectionné dans l'objet d'état de pipeline.

*PipelineStateFlags*   \_In\_\
Type : [D3D12XBOX\_PREFETCH\_PIPELINE\_STATE\_FLAGS](/fr-CA/reference/graphics/d3d12_x/enums/d3d12xbox_prefetch_pipeline_state_flags)

Indicateurs qui sélectionnent les programmes de nuanceur de l'objet d'état de pipeline devant être prélus.

*Flags*   \_In\_\
Type : [D3D12XBOX\_PREFETCH\_MEMORY\_FLAGS](/fr-CA/reference/graphics/d3d12_x/enums/d3d12xbox_prefetch_memory_flags)

Indicateurs qui contrôlent la nature de l'opération de prélecture.

### Valeur de retour

Type : void

## Remarques

L'implémentation de PrefetchPipelineStateX appelle en fait l'API [PrefetchMemoryX](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_prefetchmemoryx) une fois pour chaque programme de nuanceur sélectionné dans l'objet d'état de pipeline, en utilisant l'adresse de base du programme de nuanceur et la taille spécifiée par le paramètre ShaderPrefetchSizeBytes.

## Configuration requise

**En-tête :** d3d12\_x.h et d3d12\_xs.h

**Bibliothèque :** d3d12\_x.lib ou d3d12\_xs.lib

**Plateformes prises en charge :** consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[PrefetchMemoryX](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_prefetchmemoryx)

[ID3D12GraphicsCommandList](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/id3d12graphicscommandlist)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [SetPipelineState](/fr-CA/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setpipelinestate_public.md)
- [CreateComputePipelineState](/fr-CA/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcomputepipelinestate_public.md)
- [CreateGraphicsPipelineState](/fr-CA/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_creategraphicspipelinestate_public.md)
- [D3D12_CACHED_PIPELINE_STATE](/fr-CA/reference/graphics/d3d12/structs/d3d12_cached_pipeline_state_public.md)