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

# PrefetchMemoryX (famille XBOX One)

> PrefetchMemoryX (consoles de la famille XBOX One) — Effectue la prélecture de la mémoire à l'adresse spécifiée. Référence de l'API graphique Direct3D 12 pour le développement de jeux vidéo XBOX.

Effectue la prélecture de la mémoire à l'adresse spécifiée dans le cache graphique de niveau 2.

## Syntaxe

```cpp theme={null}
void PrefetchMemoryX(  
         D3D12_GPU_VIRTUAL_ADDRESS BaseAddress,  
         UINT64 SizeBytes,  
         D3D12XBOX_PREFETCH_MEMORY_FLAGS Flags  
)  
```

### Paramètres

*BaseAddress*   \_In\_\
Type : [D3D12\_GPU\_VIRTUAL\_ADDRESS](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12_gpu_virtual_address)

L'adresse de base.

*SizeBytes*   \_In\_\
Type : UINT64

La quantité de mémoire à prélire.

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

Indicateurs de l'opération de prélecture, y compris la possibilité de sélectionner le moteur du processeur de commandes utilisé pour lancer la prélecture.

### Valeur de retour

Type : void

Aucune.

## Remarques

La prélecture de la mémoire est effectuée à l'aide de l'unité CPDMA du processeur de commandes.
L'unité CPDMA peut mettre en file d'attente jusqu'à deux copies en attente à la fois sans blocage; d'autres requêtes simultanées bloqueront le processeur de commandes jusqu'à ce qu'un nombre suffisant d'opérations CPDMA soient terminées pour débloquer la file d'attente.
Lorsque des requêtes CPDMA sont soumises, il existe une file d'attente FIFO de 2 entrées sur les moteurs ME et PFP du processeur de commandes.
Les requêtes sont soumises à l'unité CPDMA à partir des files d'attente PFP et ME selon un mode tourniquet (round-robin).

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

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

[PrefetchPipelineStateX](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_prefetchpipelinestatex)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [Documentation de développement de jeux XBOX](/fr-CA/index.md)
- [NDA 토픽 디렉터리 - Microsoft Learn 라이브 링크](/ko/nda/nda-topic-directory.md)
- [MicrosoftGame.config Element - XboxOneXTitleMemory](/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-xboxonextitlememory.md)
- [MicrosoftGame.config 要素 - XboxOneXTitleMemory](/ja-jp/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-xboxonextitlememory.md)