LWJGL 3.3.3 · org.lwjgl.vulkan.KHRMaintenance4

VK_KHR_maintenance4 adds a collection of minor features, none of which would warrant an entire extension of their own.

The new features are as follows:

Allow the application to destroy their VkPipelineLayout object immediately after it was used to create another object. It is no longer necessary to keep its handle valid while the created object is in use.
Add a new maxBufferSize implementation-defined limit for the maximum size VkBuffer that can be created.
Add support for the SPIR-V 1.2 LocalSizeId execution mode, which can be used as an alternative to LocalSize to specify the local workgroup size with specialization constants.
Add a guarantee that images created with identical creation parameters will always have the same alignment requirements.
Add new GetDeviceBufferMemoryRequirementsKHR, GetDeviceImageMemoryRequirementsKHR, and GetDeviceImageSparseMemoryRequirementsKHR to allow the application to query the image memory requirements without having to create an image object and query it.
Relax the requirement that push constants must be initialized before they are dynamically accessed.
Relax the interface matching rules to allow a larger output vector to match with a smaller input vector, with additional values being discarded.
Add a guarantee for buffer memory requirement that the size memory requirement is never greater than the result of aligning create size with the alignment memory requirement.

Promotion to Vulkan 1.3

Functionality in this extension is included in core Vulkan 1.3, with the KHR suffix omitted. The original type, enum and command names are still available as aliases of the core functionality.

VK_KHR_maintenance4

Name String

VK_KHR_maintenance4

Extension Type

Device extension

Registered Extension Number

414

Revision

Extension and Version Dependencies

Version 1.1

Deprecation state

Promoted to Vulkan 1.3

Contact

Piers Daniell pdaniell-nv

Other Extension Metadata

Last Modified Date

2021-10-25

Interactions and External Dependencies

Promoted to Vulkan 1.3 Core
Requires SPIR-V 1.2 for LocalSizeId

Contributors

Lionel Duc, NVIDIA
Faith Ekstrand, Intel
Spencer Fricke, Samsung
Tobias Hector, AMD
Lionel Landwerlin, Intel
Graeme Leese, Broadcom
Tom Olson, Arm
Stu Smith, AMD
Yiwei Zhang, Google

Field Summary

Modifier and Type	Field and Description
public static final int	VK_IMAGE_ASPECT_NONE_KHR Extends `VkImageAspectFlagBits`.
public static final String	VK_KHR_MAINTENANCE_4_EXTENSION_NAME The extension name.
public static final int	VK_KHR_MAINTENANCE_4_SPEC_VERSION The extension specification version.
public static final int	VK_STRUCTURE_TYPE_DEVICE_BUFFER_MEMORY_REQUIREMENTS_KHR Extends `VkStructureType`.
public static final int	VK_STRUCTURE_TYPE_DEVICE_IMAGE_MEMORY_REQUIREMENTS_KHR Extends `VkStructureType`.
public static final int	VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MAINTENANCE_4_FEATURES_KHR Extends `VkStructureType`.
public static final int	VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MAINTENANCE_4_PROPERTIES_KHR Extends `VkStructureType`.

Access	Constructor and Description
protected	KHRMaintenance4()

Method Summary

Modifier and Type	Method and Description
public static void	nvkGetDeviceBufferMemoryRequirementsKHR(VkDevice device, long pInfo, long pMemoryRequirements) Unsafe version of: `GetDeviceBufferMemoryRequirementsKHR`
public static void	nvkGetDeviceImageMemoryRequirementsKHR(VkDevice device, long pInfo, long pMemoryRequirements) Unsafe version of: `GetDeviceImageMemoryRequirementsKHR`
public static void	nvkGetDeviceImageSparseMemoryRequirementsKHR(VkDevice device, long pInfo, long a pointer to an integer related to the number of sparse memory requirements available or queried, as described below. pSparseMemoryRequirementCount, long pSparseMemoryRequirements) Unsafe version of: `GetDeviceImageSparseMemoryRequirementsKHR`
public static void	vkGetDeviceBufferMemoryRequirementsKHR(VkDevice the logical device intended to own the buffer. device, VkDeviceBufferMemoryRequirements a pointer to a `VkDeviceBufferMemoryRequirements` structure containing parameters required for the memory requirements query. pInfo, VkMemoryRequirements2 a pointer to a `VkMemoryRequirements2` structure in which the memory requirements of the buffer object are returned. pMemoryRequirements) See `GetDeviceBufferMemoryRequirements`.
public static void	vkGetDeviceImageMemoryRequirementsKHR(VkDevice the logical device intended to own the image. device, VkDeviceImageMemoryRequirements a pointer to a `VkDeviceImageMemoryRequirements` structure containing parameters required for the memory requirements query. pInfo, VkMemoryRequirements2 a pointer to a `VkMemoryRequirements2` structure in which the memory requirements of the image object are returned. pMemoryRequirements) See `GetDeviceImageMemoryRequirements`.
public static void	vkGetDeviceImageSparseMemoryRequirementsKHR(VkDevice the logical device intended to own the image. device, VkDeviceImageMemoryRequirements a pointer to a `VkDeviceImageMemoryRequirements` structure containing parameters required for the memory requirements query. pInfo, IntBuffer a pointer to an integer related to the number of sparse memory requirements available or queried, as described below. pSparseMemoryRequirementCount, VkSparseImageMemoryRequirements2.Buffer either `NULL` or a pointer to an array of `VkSparseImageMemoryRequirements2` structures. pSparseMemoryRequirements) See `GetDeviceImageSparseMemoryRequirements`.
public static void	vkGetDeviceImageSparseMemoryRequirementsKHR(VkDevice device, VkDeviceImageMemoryRequirements pInfo, int[] pSparseMemoryRequirementCount, VkSparseImageMemoryRequirements2.Buffer pSparseMemoryRequirements) Array version of: `GetDeviceImageSparseMemoryRequirementsKHR`

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

VK_IMAGE_ASPECT_NONE_KHR	back to summary
public static final int VK_IMAGE_ASPECT_NONE_KHR Extends `VkImageAspectFlagBits`.

VK_KHR_MAINTENANCE_4_EXTENSION_NAME	back to summary
public static final String VK_KHR_MAINTENANCE_4_EXTENSION_NAME The extension name.

VK_KHR_MAINTENANCE_4_SPEC_VERSION	back to summary
public static final int VK_KHR_MAINTENANCE_4_SPEC_VERSION The extension specification version.

VK_STRUCTURE_TYPE_DEVICE_BUFFER_MEMORY_REQUIREMENTS_KHR back to summary

VK_STRUCTURE_TYPE_DEVICE_BUFFER_MEMORY_REQUIREMENTS_KHR	back to summary
public static final int VK_STRUCTURE_TYPE_DEVICE_BUFFER_MEMORY_REQUIREMENTS_KHR Extends `VkStructureType`. Enum values: `STRUCTURE_TYPE_PHYSICAL_DEVICE_MAINTENANCE_4_FEATURES_KHR` `STRUCTURE_TYPE_PHYSICAL_DEVICE_MAINTENANCE_4_PROPERTIES_KHR` `STRUCTURE_TYPE_DEVICE_BUFFER_MEMORY_REQUIREMENTS_KHR` `STRUCTURE_TYPE_DEVICE_IMAGE_MEMORY_REQUIREMENTS_KHR`

public static final int VK_STRUCTURE_TYPE_DEVICE_BUFFER_MEMORY_REQUIREMENTS_KHR

Extends VkStructureType.

Enum values:

VK_STRUCTURE_TYPE_DEVICE_IMAGE_MEMORY_REQUIREMENTS_KHR back to summary

VK_STRUCTURE_TYPE_DEVICE_IMAGE_MEMORY_REQUIREMENTS_KHR	back to summary
public static final int VK_STRUCTURE_TYPE_DEVICE_IMAGE_MEMORY_REQUIREMENTS_KHR Extends `VkStructureType`. Enum values: `STRUCTURE_TYPE_PHYSICAL_DEVICE_MAINTENANCE_4_FEATURES_KHR` `STRUCTURE_TYPE_PHYSICAL_DEVICE_MAINTENANCE_4_PROPERTIES_KHR` `STRUCTURE_TYPE_DEVICE_BUFFER_MEMORY_REQUIREMENTS_KHR` `STRUCTURE_TYPE_DEVICE_IMAGE_MEMORY_REQUIREMENTS_KHR`

public static final int VK_STRUCTURE_TYPE_DEVICE_IMAGE_MEMORY_REQUIREMENTS_KHR

Extends VkStructureType.

Enum values:

VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MAINTENANCE_4_FEATURES_KHR back to summary

VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MAINTENANCE_4_FEATURES_KHR	back to summary
public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MAINTENANCE_4_FEATURES_KHR Extends `VkStructureType`. Enum values: `STRUCTURE_TYPE_PHYSICAL_DEVICE_MAINTENANCE_4_FEATURES_KHR` `STRUCTURE_TYPE_PHYSICAL_DEVICE_MAINTENANCE_4_PROPERTIES_KHR` `STRUCTURE_TYPE_DEVICE_BUFFER_MEMORY_REQUIREMENTS_KHR` `STRUCTURE_TYPE_DEVICE_IMAGE_MEMORY_REQUIREMENTS_KHR`

public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MAINTENANCE_4_FEATURES_KHR

Extends VkStructureType.

Enum values:

VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MAINTENANCE_4_PROPERTIES_KHR back to summary

VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MAINTENANCE_4_PROPERTIES_KHR	back to summary
public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MAINTENANCE_4_PROPERTIES_KHR Extends `VkStructureType`. Enum values: `STRUCTURE_TYPE_PHYSICAL_DEVICE_MAINTENANCE_4_FEATURES_KHR` `STRUCTURE_TYPE_PHYSICAL_DEVICE_MAINTENANCE_4_PROPERTIES_KHR` `STRUCTURE_TYPE_DEVICE_BUFFER_MEMORY_REQUIREMENTS_KHR` `STRUCTURE_TYPE_DEVICE_IMAGE_MEMORY_REQUIREMENTS_KHR`

public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MAINTENANCE_4_PROPERTIES_KHR

Extends VkStructureType.

Enum values:

Constructor Detail

KHRMaintenance4	back to summary
protected KHRMaintenance4()

Method Detail

nvkGetDeviceBufferMemoryRequirementsKHR	back to summary
public static void nvkGetDeviceBufferMemoryRequirementsKHR(VkDevice device, long pInfo, long pMemoryRequirements) Unsafe version of: `GetDeviceBufferMemoryRequirementsKHR`

nvkGetDeviceImageMemoryRequirementsKHR	back to summary
public static void nvkGetDeviceImageMemoryRequirementsKHR(VkDevice device, long pInfo, long pMemoryRequirements) Unsafe version of: `GetDeviceImageMemoryRequirementsKHR`

nvkGetDeviceImageSparseMemoryRequirementsKHR back to summary

nvkGetDeviceImageSparseMemoryRequirementsKHR	back to summary
public static void nvkGetDeviceImageSparseMemoryRequirementsKHR(VkDevice device, long pInfo, long pSparseMemoryRequirementCount, long pSparseMemoryRequirements) Unsafe version of: `GetDeviceImageSparseMemoryRequirementsKHR` Parameters pSparseMemoryRequirementCount:long a pointer to an integer related to the number of sparse memory requirements available or queried, as described below.

public static void nvkGetDeviceImageSparseMemoryRequirementsKHR(VkDevice device, long pInfo, long pSparseMemoryRequirementCount, long pSparseMemoryRequirements)

Unsafe version of: GetDeviceImageSparseMemoryRequirementsKHR

Parameters

pSparseMemoryRequirementCount:long: a pointer to an integer related to the number of sparse memory requirements available or queried, as described below.

vkGetDeviceBufferMemoryRequirementsKHR back to summary

vkGetDeviceBufferMemoryRequirementsKHR	back to summary
public static void vkGetDeviceBufferMemoryRequirementsKHR(VkDevice device, VkDeviceBufferMemoryRequirements pInfo, VkMemoryRequirements2 pMemoryRequirements) See `GetDeviceBufferMemoryRequirements`. Parameters device:VkDevice the logical device intended to own the buffer. pInfo:VkDeviceBufferMemoryRequirements a pointer to a `VkDeviceBufferMemoryRequirements` structure containing parameters required for the memory requirements query. pMemoryRequirements:VkMemoryRequirements2 a pointer to a `VkMemoryRequirements2` structure in which the memory requirements of the buffer object are returned.

public static void vkGetDeviceBufferMemoryRequirementsKHR(VkDevice device, VkDeviceBufferMemoryRequirements pInfo, VkMemoryRequirements2 pMemoryRequirements)

See GetDeviceBufferMemoryRequirements.

Parameters

device:VkDevice: the logical device intended to own the buffer.
pInfo:VkDeviceBufferMemoryRequirements: a pointer to a VkDeviceBufferMemoryRequirements structure containing parameters required for the memory requirements query.
pMemoryRequirements:VkMemoryRequirements2: a pointer to a VkMemoryRequirements2 structure in which the memory requirements of the buffer object are returned.

vkGetDeviceImageMemoryRequirementsKHR back to summary

vkGetDeviceImageMemoryRequirementsKHR	back to summary
public static void vkGetDeviceImageMemoryRequirementsKHR(VkDevice device, VkDeviceImageMemoryRequirements pInfo, VkMemoryRequirements2 pMemoryRequirements) See `GetDeviceImageMemoryRequirements`. Parameters device:VkDevice the logical device intended to own the image. pInfo:VkDeviceImageMemoryRequirements a pointer to a `VkDeviceImageMemoryRequirements` structure containing parameters required for the memory requirements query. pMemoryRequirements:VkMemoryRequirements2 a pointer to a `VkMemoryRequirements2` structure in which the memory requirements of the image object are returned.

public static void vkGetDeviceImageMemoryRequirementsKHR(VkDevice device, VkDeviceImageMemoryRequirements pInfo, VkMemoryRequirements2 pMemoryRequirements)

See GetDeviceImageMemoryRequirements.

Parameters

device:VkDevice: the logical device intended to own the image.
pInfo:VkDeviceImageMemoryRequirements: a pointer to a VkDeviceImageMemoryRequirements structure containing parameters required for the memory requirements query.
pMemoryRequirements:VkMemoryRequirements2: a pointer to a VkMemoryRequirements2 structure in which the memory requirements of the image object are returned.

vkGetDeviceImageSparseMemoryRequirementsKHR back to summary

vkGetDeviceImageSparseMemoryRequirementsKHR	back to summary
public static void vkGetDeviceImageSparseMemoryRequirementsKHR(VkDevice device, VkDeviceImageMemoryRequirements pInfo, IntBuffer pSparseMemoryRequirementCount, VkSparseImageMemoryRequirements2.Buffer pSparseMemoryRequirements) See `GetDeviceImageSparseMemoryRequirements`. Parameters device:VkDevice the logical device intended to own the image. pInfo:VkDeviceImageMemoryRequirements a pointer to a `VkDeviceImageMemoryRequirements` structure containing parameters required for the memory requirements query. pSparseMemoryRequirementCount:IntBuffer a pointer to an integer related to the number of sparse memory requirements available or queried, as described below. pSparseMemoryRequirements:VkSparseImageMemoryRequirements2.Buffer either `NULL` or a pointer to an array of `VkSparseImageMemoryRequirements2` structures.

public static void vkGetDeviceImageSparseMemoryRequirementsKHR(VkDevice device, VkDeviceImageMemoryRequirements pInfo, IntBuffer pSparseMemoryRequirementCount, VkSparseImageMemoryRequirements2.Buffer pSparseMemoryRequirements)

See GetDeviceImageSparseMemoryRequirements.

Parameters

device:VkDevice: the logical device intended to own the image.
pInfo:VkDeviceImageMemoryRequirements: a pointer to a VkDeviceImageMemoryRequirements structure containing parameters required for the memory requirements query.
pSparseMemoryRequirementCount:IntBuffer: a pointer to an integer related to the number of sparse memory requirements available or queried, as described below.
pSparseMemoryRequirements:VkSparseImageMemoryRequirements2.Buffer: either NULL or a pointer to an array of VkSparseImageMemoryRequirements2 structures.

vkGetDeviceImageSparseMemoryRequirementsKHR	back to summary
public static void vkGetDeviceImageSparseMemoryRequirementsKHR(VkDevice device, VkDeviceImageMemoryRequirements pInfo, int[] pSparseMemoryRequirementCount, VkSparseImageMemoryRequirements2.Buffer pSparseMemoryRequirements) Array version of: `GetDeviceImageSparseMemoryRequirementsKHR`

public Class KHRMaintenance4

Promotion to Vulkan 1.3

VK_KHR_maintenance4

Other Extension Metadata

Field Summary

Constructor Summary

Method Summary

Field Detail

Enum values:

Enum values:

Enum values:

Enum values:

Constructor Detail

Method Detail