> ## 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 (consoles XBOX Series)

> PrefetchMemoryX (consoles XBOX Series) : prérécupère la mémoire à l'adresse spécifiée. Référence de l'API graphique Direct3D 12 pour le développement de jeux XBOX.

Prérécupère 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

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

Adresse de base.

*SizeBytes*   \_In\_\
Type : UINT64

Quantité de mémoire à prérécupérer.

*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érécupération, notamment la possibilité de sélectionner le moteur du processeur de commandes utilisé pour lancer la prérécupération.

### Valeur renvoyée

Type : void

Aucune.

## Remarques

La prérécupération 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; les demandes simultanées supplémentaires bloquent le processeur de commandes jusqu'à ce que suffisamment d'opérations CPDMA soient terminées pour débloquer la file d'attente.
Lorsque des demandes CPDMA sont soumises, une file d'attente FIFO de 2 entrées est utilisée sur les moteurs ME et PFP du processeur de commandes.
Les demandes sont soumises à l'unité CPDMA à partir des files d'attente PFP et ME à tour de rôle.

## Configuration requise

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

**Bibliothèque :** d3d12\_xs.lib\
**Plateformes prises en charge** : consoles XBOX Series

## Voir aussi

[ID3D12GraphicsCommandList6](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/id3d12graphicscommandlist6)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [Cross Core Memory Costs](/build/console-features/memory/Cross-Core-Memory-Costs.md)
- [DXGI_ADAPTER_DESC2 (XBOX Series consoles)](/reference/graphics/d3d12_xs/structs/dxgi_adapter_desc2.md)