Safe Haskell | Safe-Inferred |
---|---|
Language | Haskell2010 |
Name
VK_EXT_memory_budget - device extension
VK_EXT_memory_budget
- Name String
VK_EXT_memory_budget
- Extension Type
- Device extension
- Registered Extension Number
- 238
- Revision
- 1
- Ratification Status
- Not ratified
- 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
Description
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 PhysicalDeviceMemoryBudgetPropertiesEXT
::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 PhysicalDeviceMemoryBudgetPropertiesEXT
::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.
New Structures
New Enum Constants
EXT_MEMORY_BUDGET_SPEC_VERSION
Extending
StructureType
:
Version History
Revision 1, 2018-10-08 (Jeff Bolz)
- Initial revision
See Also
PhysicalDeviceMemoryBudgetPropertiesEXT
Document Notes
For more information, see the Vulkan Specification
This page is a generated document. Fixes and changes should be made to the generator scripts, not directly.
Synopsis
- data PhysicalDeviceMemoryBudgetPropertiesEXT = PhysicalDeviceMemoryBudgetPropertiesEXT {}
- type EXT_MEMORY_BUDGET_SPEC_VERSION = 1
- pattern EXT_MEMORY_BUDGET_SPEC_VERSION :: forall a. Integral a => a
- type EXT_MEMORY_BUDGET_EXTENSION_NAME = "VK_EXT_memory_budget"
- pattern EXT_MEMORY_BUDGET_EXTENSION_NAME :: forall a. (Eq a, IsString a) => a
Documentation
data PhysicalDeviceMemoryBudgetPropertiesEXT Source #
VkPhysicalDeviceMemoryBudgetPropertiesEXT - Structure specifying physical device memory budget and usage
Description
The values returned in this structure are not invariant. The
heapBudget
and heapUsage
values must be zero for array elements
greater than or equal to
PhysicalDeviceMemoryProperties
::memoryHeapCount
.
The heapBudget
value must be non-zero for array elements less than
PhysicalDeviceMemoryProperties
::memoryHeapCount
.
The heapBudget
value must be less than or equal to
MemoryHeap
::size
for each heap.
Valid Usage (Implicit)
See Also
PhysicalDeviceMemoryBudgetPropertiesEXT | |
|
Instances
type EXT_MEMORY_BUDGET_SPEC_VERSION = 1 Source #
pattern EXT_MEMORY_BUDGET_SPEC_VERSION :: forall a. Integral a => a Source #
type EXT_MEMORY_BUDGET_EXTENSION_NAME = "VK_EXT_memory_budget" Source #
pattern EXT_MEMORY_BUDGET_EXTENSION_NAME :: forall a. (Eq a, IsString a) => a Source #