Package org.lwjgl.vulkan
Class VkMemoryDedicatedAllocateInfo
java.lang.Object
org.lwjgl.system.Pointer.Default
org.lwjgl.system.Struct<VkMemoryDedicatedAllocateInfo>
org.lwjgl.vulkan.VkMemoryDedicatedAllocateInfo
- All Implemented Interfaces:
AutoCloseable
,NativeResource
,Pointer
- Direct Known Subclasses:
VkMemoryDedicatedAllocateInfoKHR
public class VkMemoryDedicatedAllocateInfo
extends Struct<VkMemoryDedicatedAllocateInfo>
implements NativeResource
Specify a dedicated memory allocation resource.
Valid Usage
- At least one of
image
andbuffer
must beNULL_HANDLE
- If
image
is notNULL_HANDLE
and the memory is not an imported Android Hardware Buffer ,VkMemoryAllocateInfo
::allocationSize
must equal theVkMemoryRequirements
::size
of the image - If
image
is notNULL_HANDLE
,image
must have been created withoutIMAGE_CREATE_SPARSE_BINDING_BIT
set inVkImageCreateInfo
::flags
- If
buffer
is notNULL_HANDLE
and the memory is not an imported Android Hardware Buffer ,VkMemoryAllocateInfo
::allocationSize
must equal theVkMemoryRequirements
::size
of the buffer - If
buffer
is notNULL_HANDLE
,buffer
must have been created withoutBUFFER_CREATE_SPARSE_BINDING_BIT
set inVkBufferCreateInfo
::flags
- If
image
is notNULL_HANDLE
andVkMemoryAllocateInfo
defines a memory import operation with handle typeEXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_WIN32_BIT
,EXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_WIN32_KMT_BIT
,EXTERNAL_MEMORY_HANDLE_TYPE_D3D11_TEXTURE_BIT
,EXTERNAL_MEMORY_HANDLE_TYPE_D3D11_TEXTURE_KMT_BIT
,EXTERNAL_MEMORY_HANDLE_TYPE_D3D12_HEAP_BIT
, orEXTERNAL_MEMORY_HANDLE_TYPE_D3D12_RESOURCE_BIT
, and the external handle was created by the Vulkan API, then the memory being imported must also be a dedicated image allocation andimage
must be identical to the image associated with the imported memory - If
buffer
is notNULL_HANDLE
andVkMemoryAllocateInfo
defines a memory import operation with handle typeEXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_WIN32_BIT
,EXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_WIN32_KMT_BIT
,EXTERNAL_MEMORY_HANDLE_TYPE_D3D11_TEXTURE_BIT
,EXTERNAL_MEMORY_HANDLE_TYPE_D3D11_TEXTURE_KMT_BIT
,EXTERNAL_MEMORY_HANDLE_TYPE_D3D12_HEAP_BIT
, orEXTERNAL_MEMORY_HANDLE_TYPE_D3D12_RESOURCE_BIT
, and the external handle was created by the Vulkan API, then the memory being imported must also be a dedicated buffer allocation andbuffer
must be identical to the buffer associated with the imported memory - If
image
is notNULL_HANDLE
andVkMemoryAllocateInfo
defines a memory import operation with handle typeEXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_FD_BIT
, the memory being imported must also be a dedicated image allocation andimage
must be identical to the image associated with the imported memory - If
buffer
is notNULL_HANDLE
andVkMemoryAllocateInfo
defines a memory import operation with handle typeEXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_FD_BIT
, the memory being imported must also be a dedicated buffer allocation andbuffer
must be identical to the buffer associated with the imported memory - If
image
is notNULL_HANDLE
,image
must not have been created withIMAGE_CREATE_DISJOINT_BIT
set inVkImageCreateInfo
::flags
Valid Usage (Implicit)
sType
must beSTRUCTURE_TYPE_MEMORY_DEDICATED_ALLOCATE_INFO
- If
image
is notNULL_HANDLE
,image
must be a validVkImage
handle - If
buffer
is notNULL_HANDLE
,buffer
must be a validVkBuffer
handle - Both of
buffer
, andimage
that are valid handles of non-ignored parameters must have been created, allocated, or retrieved from the sameVkDevice
Layout
struct VkMemoryDedicatedAllocateInfo {
VkStructureType sType()
;
void const * pNext()
;
VkImage image()
;
VkBuffer buffer()
;
}
-
Nested Class Summary
Nested classes/interfaces inherited from class org.lwjgl.system.Struct
Struct.StructValidation
Nested classes/interfaces inherited from interface org.lwjgl.system.Pointer
Pointer.Default
-
Field Summary
Modifier and TypeFieldDescriptionstatic final int
The struct alignment in bytes.static final int
The struct member offsets.static final int
The struct member offsets.static final int
The struct member offsets.static final int
The struct size in bytes.static final int
The struct member offsets.Fields inherited from interface org.lwjgl.system.Pointer
BITS32, BITS64, CLONG_SHIFT, CLONG_SIZE, POINTER_SHIFT, POINTER_SIZE
-
Constructor Summary
ConstructorDescriptionVkMemoryDedicatedAllocateInfo
(ByteBuffer container) Creates aVkMemoryDedicatedAllocateInfo
instance at the current position of the specifiedByteBuffer
container. -
Method Summary
Modifier and TypeMethodDescriptionlong
buffer()
NULL_HANDLE
or a handle of a buffer which this memory will be bound to.buffer
(long value) Sets the specified value to thebuffer()
field.calloc()
Returns a newVkMemoryDedicatedAllocateInfo
instance allocated withmemCalloc
.calloc
(int capacity) Returns a newVkMemoryDedicatedAllocateInfo.Buffer
instance allocated withmemCalloc
.calloc
(int capacity, MemoryStack stack) Returns a newVkMemoryDedicatedAllocateInfo.Buffer
instance allocated on the specifiedMemoryStack
and initializes all its bits to zero.calloc
(MemoryStack stack) Returns a newVkMemoryDedicatedAllocateInfo
instance allocated on the specifiedMemoryStack
and initializes all its bits to zero.Deprecated.callocStack
(int capacity) Deprecated.callocStack
(int capacity, MemoryStack stack) Deprecated.callocStack
(MemoryStack stack) Deprecated.create()
Returns a newVkMemoryDedicatedAllocateInfo
instance allocated withBufferUtils
.create
(int capacity) Returns a newVkMemoryDedicatedAllocateInfo.Buffer
instance allocated withBufferUtils
.create
(long address) Returns a newVkMemoryDedicatedAllocateInfo
instance for the specified memory address.create
(long address, int capacity) Create aVkMemoryDedicatedAllocateInfo.Buffer
instance at the specified memory.createSafe
(long address) createSafe
(long address, int capacity) long
image()
NULL_HANDLE
or a handle of an image which this memory will be bound to.image
(long value) Sets the specified value to theimage()
field.malloc()
Returns a newVkMemoryDedicatedAllocateInfo
instance allocated withmemAlloc
.malloc
(int capacity) Returns a newVkMemoryDedicatedAllocateInfo.Buffer
instance allocated withmemAlloc
.malloc
(int capacity, MemoryStack stack) Returns a newVkMemoryDedicatedAllocateInfo.Buffer
instance allocated on the specifiedMemoryStack
.malloc
(MemoryStack stack) Returns a newVkMemoryDedicatedAllocateInfo
instance allocated on the specifiedMemoryStack
.Deprecated.mallocStack
(int capacity) Deprecated.mallocStack
(int capacity, MemoryStack stack) Deprecated.mallocStack
(MemoryStack stack) Deprecated.static long
nbuffer
(long struct) Unsafe version ofbuffer()
.static void
nbuffer
(long struct, long value) Unsafe version ofbuffer
.static long
nimage
(long struct) Unsafe version ofimage()
.static void
nimage
(long struct, long value) Unsafe version ofimage
.static long
npNext
(long struct) Unsafe version ofpNext()
.static void
npNext
(long struct, long value) Unsafe version ofpNext
.static int
nsType
(long struct) Unsafe version ofsType()
.static void
nsType
(long struct, int value) Unsafe version ofsType
.long
pNext()
NULL
or a pointer to a structure extending this structure.pNext
(long value) Sets the specified value to thepNext()
field.set
(int sType, long pNext, long image, long buffer) Initializes this struct with the specified values.Copies the specified struct data to this struct.int
sizeof()
Returnssizeof(struct)
.int
sType()
aVkStructureType
value identifying this structure.sType
(int value) Sets the specified value to thesType()
field.Sets theSTRUCTURE_TYPE_MEMORY_DEDICATED_ALLOCATE_INFO
value to thesType()
field.Methods inherited from class org.lwjgl.system.Pointer.Default
address, equals, hashCode, toString
Methods inherited from interface org.lwjgl.system.NativeResource
close, free
-
Field Details
-
SIZEOF
public static final int SIZEOFThe struct size in bytes. -
ALIGNOF
public static final int ALIGNOFThe struct alignment in bytes. -
STYPE
public static final int STYPEThe struct member offsets. -
PNEXT
public static final int PNEXTThe struct member offsets. -
IMAGE
public static final int IMAGEThe struct member offsets. -
BUFFER
public static final int BUFFERThe struct member offsets.
-
-
Constructor Details
-
VkMemoryDedicatedAllocateInfo
Creates aVkMemoryDedicatedAllocateInfo
instance at the current position of the specifiedByteBuffer
container. Changes to the buffer's content will be visible to the struct instance and vice versa.The created instance holds a strong reference to the container object.
-
-
Method Details
-
sizeof
public int sizeof()Description copied from class:Struct
Returnssizeof(struct)
.- Specified by:
sizeof
in classStruct<VkMemoryDedicatedAllocateInfo>
-
sType
public int sType()aVkStructureType
value identifying this structure. -
pNext
public long pNext()NULL
or a pointer to a structure extending this structure. -
image
public long image()NULL_HANDLE
or a handle of an image which this memory will be bound to. -
buffer
public long buffer()NULL_HANDLE
or a handle of a buffer which this memory will be bound to. -
sType
Sets the specified value to thesType()
field. -
sType$Default
Sets theSTRUCTURE_TYPE_MEMORY_DEDICATED_ALLOCATE_INFO
value to thesType()
field. -
pNext
Sets the specified value to thepNext()
field. -
image
Sets the specified value to theimage()
field. -
buffer
Sets the specified value to thebuffer()
field. -
set
Initializes this struct with the specified values. -
set
Copies the specified struct data to this struct.- Parameters:
src
- the source struct- Returns:
- this struct
-
malloc
Returns a newVkMemoryDedicatedAllocateInfo
instance allocated withmemAlloc
. The instance must be explicitly freed. -
calloc
Returns a newVkMemoryDedicatedAllocateInfo
instance allocated withmemCalloc
. The instance must be explicitly freed. -
create
Returns a newVkMemoryDedicatedAllocateInfo
instance allocated withBufferUtils
. -
create
Returns a newVkMemoryDedicatedAllocateInfo
instance for the specified memory address. -
createSafe
-
malloc
Returns a newVkMemoryDedicatedAllocateInfo.Buffer
instance allocated withmemAlloc
. The instance must be explicitly freed.- Parameters:
capacity
- the buffer capacity
-
calloc
Returns a newVkMemoryDedicatedAllocateInfo.Buffer
instance allocated withmemCalloc
. The instance must be explicitly freed.- Parameters:
capacity
- the buffer capacity
-
create
Returns a newVkMemoryDedicatedAllocateInfo.Buffer
instance allocated withBufferUtils
.- Parameters:
capacity
- the buffer capacity
-
create
Create aVkMemoryDedicatedAllocateInfo.Buffer
instance at the specified memory.- Parameters:
address
- the memory addresscapacity
- the buffer capacity
-
createSafe
-
mallocStack
Deprecated.Deprecated for removal in 3.4.0. Usemalloc(MemoryStack)
instead. -
callocStack
Deprecated.Deprecated for removal in 3.4.0. Usecalloc(MemoryStack)
instead. -
mallocStack
Deprecated.Deprecated for removal in 3.4.0. Usemalloc(MemoryStack)
instead. -
callocStack
Deprecated.Deprecated for removal in 3.4.0. Usecalloc(MemoryStack)
instead. -
mallocStack
Deprecated.Deprecated for removal in 3.4.0. Usemalloc(int, MemoryStack)
instead. -
callocStack
Deprecated.Deprecated for removal in 3.4.0. Usecalloc(int, MemoryStack)
instead. -
mallocStack
@Deprecated public static VkMemoryDedicatedAllocateInfo.Buffer mallocStack(int capacity, MemoryStack stack) Deprecated.Deprecated for removal in 3.4.0. Usemalloc(int, MemoryStack)
instead. -
callocStack
@Deprecated public static VkMemoryDedicatedAllocateInfo.Buffer callocStack(int capacity, MemoryStack stack) Deprecated.Deprecated for removal in 3.4.0. Usecalloc(int, MemoryStack)
instead. -
malloc
Returns a newVkMemoryDedicatedAllocateInfo
instance allocated on the specifiedMemoryStack
.- Parameters:
stack
- the stack from which to allocate
-
calloc
Returns a newVkMemoryDedicatedAllocateInfo
instance allocated on the specifiedMemoryStack
and initializes all its bits to zero.- Parameters:
stack
- the stack from which to allocate
-
malloc
Returns a newVkMemoryDedicatedAllocateInfo.Buffer
instance allocated on the specifiedMemoryStack
.- Parameters:
capacity
- the buffer capacitystack
- the stack from which to allocate
-
calloc
Returns a newVkMemoryDedicatedAllocateInfo.Buffer
instance allocated on the specifiedMemoryStack
and initializes all its bits to zero.- Parameters:
capacity
- the buffer capacitystack
- the stack from which to allocate
-
nsType
public static int nsType(long struct) Unsafe version ofsType()
. -
npNext
public static long npNext(long struct) Unsafe version ofpNext()
. -
nimage
public static long nimage(long struct) Unsafe version ofimage()
. -
nbuffer
public static long nbuffer(long struct) Unsafe version ofbuffer()
. -
nsType
public static void nsType(long struct, int value) Unsafe version ofsType
. -
npNext
public static void npNext(long struct, long value) Unsafe version ofpNext
. -
nimage
public static void nimage(long struct, long value) Unsafe version ofimage
. -
nbuffer
public static void nbuffer(long struct, long value) Unsafe version ofbuffer
.
-