> ## 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 (XBOX One 系列)

> 初始化圖形記憶體追蹤

<Note>
  即將新增與 D3DConfigureVirtualMemory 對等的 D3D12 API。
</Note>

保留記憶體並初始化用於追蹤圖形記憶體的分頁表。

<Note>
  請注意，在未來版本的 Microsoft Gaming SDK 中，此 API 可能會被淘汰，改用 D3D12 變體。
</Note>

## 語法

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

### 參數

*pVMConfiguration*   \_Inout\_\
類型：D3D11X\_VIRTUAL\_MEMORY\_CONFIGURATION\*

指向用於初始化圖形記憶體之虛擬記憶體設定選項的指標。

### 傳回值

類型：HRESULT

| 結果 | 原因 |
| - | - |
| S\_OK | 已使用指定的設定來設定虛擬記憶體系統。 |
| E\_FAIL | 未成功設定虛擬記憶體系統 (亦即在呼叫此 API 之前已建立一或多個圖形配置)。 |
| E\_INVALIDARG | pVMConfiguration 為 NULL。 |

### 備註

**D3DConfigureVirtualMemory** 可讓您在建立 D3DDevice 之前初始化圖形記憶體追蹤。只有在您的遊戲需要在啟動初期、建立 D3DDevice 之前配置圖形記憶體保留時，才需要呼叫此 API。

```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));
```

## 需求

**標頭:** d3d11\_x.h (由 d3d12\_x.h 包含)

程式庫: 使用 \*\*\*\*.lib

**支援的平台:** XBOX One 系列

## 另請參閱

[d3d12\_x](/zh-TW/reference/graphics/d3d12_x/d3d12_x_members)


## Related topics

- [D3D12_MEMORY_POOL](/zh-TW/reference/graphics/d3d12/enums/d3d12_memory_pool_public.md)
- [D3D12_GPU_VIRTUAL_ADDRESS_RANGE](/zh-TW/reference/graphics/d3d12/structs/d3d12_gpu_virtual_address_range_public.md)
- [D3D12_GPU_VIRTUAL_ADDRESS_AND_STRIDE](/zh-TW/reference/graphics/d3d12/structs/d3d12_gpu_virtual_address_and_stride_public.md)
- [D3D12_GPU_VIRTUAL_ADDRESS_RANGE_AND_STRIDE](/zh-TW/reference/graphics/d3d12/structs/d3d12_gpu_virtual_address_range_and_stride_public.md)
- [D3D12_FEATURE_DATA_GPU_VIRTUAL_ADDRESS_SUPPORT](/zh-TW/reference/graphics/d3d12/structs/d3d12_feature_data_gpu_virtual_address_support_public.md)