Package org.lwjgl.vulkan

Class EXTMemoryBudget

java.lang.Object
org.lwjgl.vulkan.EXTMemoryBudget
public final class EXTMemoryBudget extends Object
While running a Vulkan application, other processes on the machine might also be attempting to use the same device memory, which can pose problems. This extension adds support for querying the amount of memory used and the total memory budget for a memory heap. The values returned by this query are implementation-dependent and can depend on a variety of factors including operating system and system load.

The VkPhysicalDeviceMemoryBudgetPropertiesEXT::heapBudget values can be used as a guideline for how much total memory from each heap the current process can use at any given time, before allocations may start failing or causing performance degradation. The values may change based on other activity in the system that is outside the scope and control of the Vulkan implementation.

The VkPhysicalDeviceMemoryBudgetPropertiesEXT::heapUsage will display the current process estimated heap usage.

With this information, the idea is for an application at some interval (once per frame, per few seconds, etc) to query heapBudget and heapUsage. From here the application can notice if it is over budget and decide how it wants to handle the memory situation (free it, move to host memory, changing mipmap levels, etc). This extension is designed to be used in concert with VK_EXT_memory_priority to help with this part of memory management.

Name String
VK_EXT_memory_budget
Extension Type
Device extension
Registered Extension Number
238
Revision
1
Extension and Version Dependencies
VK_KHR_get_physical_device_properties2 or Version 1.1
Contact
Other Extension Metadata
Last Modified Date
2018-10-08
Contributors
  • Jeff Bolz, NVIDIA
  • Jeff Juliano, NVIDIA

  • Field Details

    • VK_EXT_MEMORY_BUDGET_SPEC_VERSION

      public static final int VK_EXT_MEMORY_BUDGET_SPEC_VERSION
      The extension specification version.
      See Also:

    • VK_EXT_MEMORY_BUDGET_EXTENSION_NAME

      public static final String VK_EXT_MEMORY_BUDGET_EXTENSION_NAME
      The extension name.
      See Also:

    • VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MEMORY_BUDGET_PROPERTIES_EXT

      public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MEMORY_BUDGET_PROPERTIES_EXT
      Extends VkStructureType.
      See Also: