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

# D3DConfigureVirtualMemory (família XBOX One)

> Inicializa o rastreamento de memória gráfica

<Note>
  Uma API equivalente em D3D12 para D3DConfigureVirtualMemory será adicionada em breve.
</Note>

Reserva memória e inicializa as tabelas de páginas para rastrear a memória gráfica.

<Note>
  Observe que esta API poderá ser preterida em uma versão futura do Microsoft Gaming SDK em favor de uma variante D3D12.
</Note>

## Sintaxe

```cpp theme={null}
HRESULT D3DConfigureVirtualMemory(
    _Inout_ D3D11X_VIRTUAL_MEMORY_CONFIGURATION* pVMConfiguration );
)  
```

### Parâmetros

*pVMConfiguration*   \_Inout\_\
Tipo: D3D11X\_VIRTUAL\_MEMORY\_CONFIGURATION\*

Um ponteiro para as opções de configuração de memória virtual a serem usadas para inicializar a memória gráfica.

### Valor retornado

Tipo: HRESULT

| Resultado | Motivo |
| - | - |
| S\_OK | O sistema de memória virtual foi configurado com a configuração fornecida. |
| E\_FAIL | O sistema de memória virtual não foi configurado com êxito (ou seja, uma ou mais alocações gráficas foram criadas antes da chamada a esta API). |
| E\_INVALIDARG | pVMConfiguration é NULL. |

### Comentários

**D3DConfigureVirtualMemory** permite inicializar o rastreamento de memória gráfica antes que um D3DDevice tenha sido criado.  Só é necessário chamar esta API se o seu título precisar alocar reservas de memória gráfica no início da inicialização, antes da criação de um D3DDevice.

```cpp theme={null}
D3D11X_VIRTUAL_MEMORY_CONFIGURATION config {0};
// the default when allowing D3D12 to initialize graphics memory page tables
config.PageTableMemory4MBPageCount = 5;  
ThrowIfFailed(D3DConfigureVirtualMemory(&config));
```

## Requisitos

**Cabeçalho:** d3d11\_x.h (incluído por d3d12\_x.h)

Biblioteca: use \*\*\*\*.lib

**Plataformas com suporte:** família XBOX One

## Confira também

[d3d12\_x](/pt-BR/reference/graphics/d3d12_x/d3d12_x_members)
d3d12
d3d12\_x


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [D3D12_MEMORY_POOL](/es/reference/graphics/d3d12/enums/d3d12_memory_pool_public.md)
- [D3D12_GPU_VIRTUAL_ADDRESS_RANGE](/es/reference/graphics/d3d12/structs/d3d12_gpu_virtual_address_range_public.md)
- [D3D12_GPU_VIRTUAL_ADDRESS_AND_STRIDE](/es/reference/graphics/d3d12/structs/d3d12_gpu_virtual_address_and_stride_public.md)
- [D3D12_GPU_VIRTUAL_ADDRESS_RANGE_AND_STRIDE](/es/reference/graphics/d3d12/structs/d3d12_gpu_virtual_address_range_and_stride_public.md)