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

> PrefetchMemoryX (consoles da família XBOX One) — Faz a pré-busca da memória no endereço especificado. Referência da API de gráficos do Direct3D 12 para desenvolvimento de jogos para XBOX.

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

## 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](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 para pré-busca.

*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 dentro do processador de comandos é usado para iniciar a pré-busca.

### Valor retornado

Tipo: void

Nenhum.

## Comentários

A pré-busca de memória é realizada 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 CPDMA suficientes sejam concluídas para desbloquear a fila.
Quando solicitações 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 rodízio (round-robin).

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

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

[PrefetchPipelineStateX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_prefetchpipelinestatex)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [Directorio de temas NDA: enlaces activos a Microsoft Learn](/es/nda/nda-topic-directory.md)
- [PIXRecordMemoryAllocationEvent](/es/reference/tools/pix3/functions/pixrecordmemoryallocationevent.md)
- [PIXRecordMemoryFreeEvent](/es/reference/tools/pix3/functions/pixrecordmemoryfreeevent.md)
- [game_chat_allocate_memory_callback](/es/reference/chat/gamechat2/functions/game_chat_allocate_memory_callback.md)