DirectX 12 Residency Starter Library Explained
The DirectX 12 Residency Starter Library is an open-source helper library developed by Microsoft to simplify video memory (VRAM) management in DirectX 12 applications. In this article, you will learn about the primary purpose of the library, the core memory management challenges it solves, and how it automates resource residency tracking to prevent performance degradation and out-of-memory crashes.
The Shift to Explicit Memory Management
In DirectX 11, the graphics driver automatically handled memory
residency behind the scenes, dynamically deciding when resources should
reside in physical VRAM or be paged out to system RAM. DirectX 12
removed this automatic abstraction to provide developers with direct,
low-level control over the GPU. Consequently, developers inherited the
responsibility of explicitly calling APIs like MakeResident
and Evict to manage memory allocation. Failing to properly
balance these calls can lead to GPU stalls, severe frame stuttering, or
immediate application crashes when VRAM is exhausted.
The Core Purpose of the Library
The primary purpose of the DirectX 12 Residency Starter Library is to provide a turnkey, production-ready abstraction layer that handles resource residency without requiring developers to build a custom memory paging system from scratch. It bridges the gap between the convenience of DirectX 11’s driver-managed memory and the granular control offered by DirectX 12.
Key objectives of the library include:
- Budget Enforcement: It queries DXGI memory budget interfaces to monitor real-time local and non-local memory allowances assigned by the operating system, ensuring the application stays within safe thresholds.
- Automated Eviction: When memory allocations exceed the designated operating system budget, the library automatically evicts the least recently used (LRU) resources from high-speed VRAM to prevent oversubscription.
- Command List Synchronization: The library coordinates with active command lists to guarantee that resources currently in use by the GPU are never evicted prematurely, avoiding access violations and rendering artifacts.
- Oversubscription Handling: When a scene requires more VRAM than is physically available, the library gracefully degrades performance by streaming or falling back to system memory rather than terminating the process with an out-of-memory error.
Why Developers Use It
Building a robust memory residency manager requires deep expertise in OS-level paging, fence synchronization, and asynchronous resource tracking. The DirectX 12 Residency Starter Library serves as either an immediate integration for indie and enterprise engines or as a reference architecture for teams designing proprietary memory managers. By handling the complexities of residency behind a lightweight interface, it allows developers to focus on rendering techniques and gameplay mechanics while maintaining memory stability across various hardware configurations.