Package org.lwjgl.vulkan

Class EXTMemoryBudget

  • public final class EXTMemoryBudget
extends java.lang.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.

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

    • Field Detail

      • VK_EXT_MEMORY_BUDGET_SPEC_VERSION

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

      • VK_EXT_MEMORY_BUDGET_EXTENSION_NAME

        public static final java.lang.String VK_EXT_MEMORY_BUDGET_EXTENSION_NAME
        The extension name.
        See Also:
        Constant Field Values

      • 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:
        Constant Field Values