> ## 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) — Faz a pré-busca da memória no endereço especificado. Referência da API gráfica Direct3D 12 para desenvolvimento de jogos para XBOX.

Faz a pré-busca da memória no endereço especificado para o cache de nível 2 de gráficos.

## Sintaxe

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

### Parâmetros

*BaseAddress*   \_In\_\
Tipo: D3D12\_GPU\_VIRTUAL\_ADDRESS

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

O endereço base.

*SizeBytes*   \_In\_\
Tipo: UINT64

A quantidade de memória a ser pré-buscada.

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

Sinalizadores para a operação de pré-busca, incluindo a capacidade de selecionar qual mecanismo do processador de comandos é usado para iniciar a pré-busca.

### Valor retornado

Tipo: void

Nenhum.

## Comentários

A pré-busca de memória é executada usando a unidade CPDMA do processador de comandos.
A unidade CPDMA pode enfileirar até duas cópias pendentes por vez sem bloqueio; solicitações simultâneas adicionais paralisarão o processador de comandos até que operações de CPDMA suficientes sejam concluídas para desbloquear a fila.
Quando as solicitações de CPDMA são enviadas, há uma fila FIFO de 2 entradas nos mecanismos ME e PFP do processador de comandos.
As solicitações são enviadas à unidade CPDMA a partir das filas PFP e ME em round-robin.

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

- [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)