Class VkBufferDeviceAddressCreateInfoEXT
- java.lang.Object
-
- org.lwjgl.system.Pointer.Default
-
- org.lwjgl.system.Struct
-
- org.lwjgl.vulkan.VkBufferDeviceAddressCreateInfoEXT
-
- All Implemented Interfaces:
java.lang.AutoCloseable,org.lwjgl.system.NativeResource,org.lwjgl.system.Pointer
public class VkBufferDeviceAddressCreateInfoEXT extends org.lwjgl.system.Struct implements org.lwjgl.system.NativeResourceRequest a specific address for a buffer.Description
If
deviceAddressis zero, no specific address is requested.If
deviceAddressis not zero,deviceAddressmust be an address retrieved from an identically created buffer on the same implementation. The buffer must also be bound to an identically createdVkDeviceMemoryobject.If this structure is not present, it is as if
deviceAddressis zero.Apps should avoid creating buffers with app-provided addresses and implementation-provided addresses in the same process, to reduce the likelihood of
ERROR_INVALID_DEVICE_ADDRESS_EXTerrors.Note
The expected usage for this is that a trace capture/replay tool will add the
BUFFER_CREATE_DEVICE_ADDRESS_CAPTURE_REPLAY_BIT_EXTflag to all buffers that useBUFFER_USAGE_SHADER_DEVICE_ADDRESS_BIT_EXT, and during capture will save the queried device addresses in the trace. During replay, the buffers will be created specifying the original address so any address values stored in the trace data will remain valid.Implementations are expected to separate such buffers in the GPU address space so normal allocations will avoid using these addresses. Apps/tools should avoid mixing app-provided and implementation-provided addresses for buffers created with
BUFFER_CREATE_DEVICE_ADDRESS_CAPTURE_REPLAY_BIT_EXT, to avoid address space allocation conflicts.Valid Usage (Implicit)
sTypemust beSTRUCTURE_TYPE_BUFFER_DEVICE_ADDRESS_CREATE_INFO_EXT
Member documentation
sType– the type of this structure.pNext–NULLor a pointer to an extension-specific structure.deviceAddress– the device address requested for the buffer.
Layout
struct VkBufferDeviceAddressCreateInfoEXT { VkStructureType sType; void const * pNext; VkDeviceAddress deviceAddress; }
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classVkBufferDeviceAddressCreateInfoEXT.BufferAn array ofVkBufferDeviceAddressCreateInfoEXTstructs.
-
Field Summary
Fields Modifier and Type Field Description static intALIGNOFThe struct alignment in bytes.static intDEVICEADDRESS
PNEXTThe struct member offsets.static intSIZEOFThe struct size in bytes.static intSTYPEThe struct member offsets.
-
Constructor Summary
Constructors Constructor Description VkBufferDeviceAddressCreateInfoEXT(java.nio.ByteBuffer container)Creates aVkBufferDeviceAddressCreateInfoEXTinstance at the current position of the specifiedByteBuffercontainer.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static VkBufferDeviceAddressCreateInfoEXTcalloc()Returns a newVkBufferDeviceAddressCreateInfoEXTinstance allocated withmemCalloc.static VkBufferDeviceAddressCreateInfoEXT.Buffercalloc(int capacity)Returns a newVkBufferDeviceAddressCreateInfoEXT.Bufferinstance allocated withmemCalloc.static VkBufferDeviceAddressCreateInfoEXTcallocStack()Returns a newVkBufferDeviceAddressCreateInfoEXTinstance allocated on the thread-localMemoryStackand initializes all its bits to zero.static VkBufferDeviceAddressCreateInfoEXT.BuffercallocStack(int capacity)Returns a newVkBufferDeviceAddressCreateInfoEXT.Bufferinstance allocated on the thread-localMemoryStackand initializes all its bits to zero.static VkBufferDeviceAddressCreateInfoEXT.BuffercallocStack(int capacity, org.lwjgl.system.MemoryStack stack)Returns a newVkBufferDeviceAddressCreateInfoEXT.Bufferinstance allocated on the specifiedMemoryStackand initializes all its bits to zero.static VkBufferDeviceAddressCreateInfoEXTcallocStack(org.lwjgl.system.MemoryStack stack)Returns a newVkBufferDeviceAddressCreateInfoEXTinstance allocated on the specifiedMemoryStackand initializes all its bits to zero.static VkBufferDeviceAddressCreateInfoEXTcreate()Returns a newVkBufferDeviceAddressCreateInfoEXTinstance allocated withBufferUtils.static VkBufferDeviceAddressCreateInfoEXT.Buffercreate(int capacity)Returns a newVkBufferDeviceAddressCreateInfoEXT.Bufferinstance allocated withBufferUtils.static VkBufferDeviceAddressCreateInfoEXTcreate(long address)Returns a newVkBufferDeviceAddressCreateInfoEXTinstance for the specified memory address.static VkBufferDeviceAddressCreateInfoEXT.Buffercreate(long address, int capacity)Create aVkBufferDeviceAddressCreateInfoEXT.Bufferinstance at the specified memory.static VkBufferDeviceAddressCreateInfoEXTcreateSafe(long address)static VkBufferDeviceAddressCreateInfoEXT.BuffercreateSafe(long address, int capacity)longdeviceAddress()Returns the value of thedeviceAddressfield.VkBufferDeviceAddressCreateInfoEXTdeviceAddress(long value)Sets the specified value to thedeviceAddressfield.static VkBufferDeviceAddressCreateInfoEXTmalloc()Returns a newVkBufferDeviceAddressCreateInfoEXTinstance allocated withmemAlloc.static VkBufferDeviceAddressCreateInfoEXT.Buffermalloc(int capacity)Returns a newVkBufferDeviceAddressCreateInfoEXT.Bufferinstance allocated withmemAlloc.static VkBufferDeviceAddressCreateInfoEXTmallocStack()Returns a newVkBufferDeviceAddressCreateInfoEXTinstance allocated on the thread-localMemoryStack.static VkBufferDeviceAddressCreateInfoEXT.BuffermallocStack(int capacity)Returns a newVkBufferDeviceAddressCreateInfoEXT.Bufferinstance allocated on the thread-localMemoryStack.static VkBufferDeviceAddressCreateInfoEXT.BuffermallocStack(int capacity, org.lwjgl.system.MemoryStack stack)Returns a newVkBufferDeviceAddressCreateInfoEXT.Bufferinstance allocated on the specifiedMemoryStack.static VkBufferDeviceAddressCreateInfoEXTmallocStack(org.lwjgl.system.MemoryStack stack)Returns a newVkBufferDeviceAddressCreateInfoEXTinstance allocated on the specifiedMemoryStack.static longndeviceAddress(long struct)Unsafe version ofdeviceAddress().static voidndeviceAddress(long struct, long value)Unsafe version ofdeviceAddress.static longnpNext(long struct)Unsafe version ofpNext().static voidnpNext(long struct, long value)Unsafe version ofpNext.static intnsType(long struct)Unsafe version ofsType().static voidnsType(long struct, int value)Unsafe version ofsType.longpNext()Returns the value of thepNextfield.VkBufferDeviceAddressCreateInfoEXTpNext(long value)Sets the specified value to thepNextfield.VkBufferDeviceAddressCreateInfoEXTset(int sType, long pNext, long deviceAddress)Initializes this struct with the specified values.VkBufferDeviceAddressCreateInfoEXTset(VkBufferDeviceAddressCreateInfoEXT src)Copies the specified struct data to this struct.intsizeof()intsType()Returns the value of thesTypefield.VkBufferDeviceAddressCreateInfoEXTsType(int value)Sets the specified value to thesTypefield.
-
-
-
Constructor Detail
-
VkBufferDeviceAddressCreateInfoEXT
public VkBufferDeviceAddressCreateInfoEXT(java.nio.ByteBuffer container)
Creates aVkBufferDeviceAddressCreateInfoEXTinstance at the current position of the specifiedByteBuffercontainer. 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 Detail
-
sizeof
public int sizeof()
- Specified by:
sizeofin classorg.lwjgl.system.Struct
-
sType
public int sType()
Returns the value of thesTypefield.
-
pNext
public long pNext()
Returns the value of thepNextfield.
-
deviceAddress
public long deviceAddress()
Returns the value of thedeviceAddressfield.
-
sType
public VkBufferDeviceAddressCreateInfoEXT sType(int value)
Sets the specified value to thesTypefield.
-
pNext
public VkBufferDeviceAddressCreateInfoEXT pNext(long value)
Sets the specified value to thepNextfield.
-
deviceAddress
public VkBufferDeviceAddressCreateInfoEXT deviceAddress(long value)
Sets the specified value to thedeviceAddressfield.
-
set
public VkBufferDeviceAddressCreateInfoEXT set(int sType, long pNext, long deviceAddress)
Initializes this struct with the specified values.
-
set
public VkBufferDeviceAddressCreateInfoEXT set(VkBufferDeviceAddressCreateInfoEXT src)
Copies the specified struct data to this struct.- Parameters:
src- the source struct- Returns:
- this struct
-
malloc
public static VkBufferDeviceAddressCreateInfoEXT malloc()
Returns a newVkBufferDeviceAddressCreateInfoEXTinstance allocated withmemAlloc. The instance must be explicitly freed.
-
calloc
public static VkBufferDeviceAddressCreateInfoEXT calloc()
Returns a newVkBufferDeviceAddressCreateInfoEXTinstance allocated withmemCalloc. The instance must be explicitly freed.
-
create
public static VkBufferDeviceAddressCreateInfoEXT create()
Returns a newVkBufferDeviceAddressCreateInfoEXTinstance allocated withBufferUtils.
-
create
public static VkBufferDeviceAddressCreateInfoEXT create(long address)
Returns a newVkBufferDeviceAddressCreateInfoEXTinstance for the specified memory address.
-
createSafe
@Nullable public static VkBufferDeviceAddressCreateInfoEXT createSafe(long address)
-
malloc
public static VkBufferDeviceAddressCreateInfoEXT.Buffer malloc(int capacity)
Returns a newVkBufferDeviceAddressCreateInfoEXT.Bufferinstance allocated withmemAlloc. The instance must be explicitly freed.- Parameters:
capacity- the buffer capacity
-
calloc
public static VkBufferDeviceAddressCreateInfoEXT.Buffer calloc(int capacity)
Returns a newVkBufferDeviceAddressCreateInfoEXT.Bufferinstance allocated withmemCalloc. The instance must be explicitly freed.- Parameters:
capacity- the buffer capacity
-
create
public static VkBufferDeviceAddressCreateInfoEXT.Buffer create(int capacity)
Returns a newVkBufferDeviceAddressCreateInfoEXT.Bufferinstance allocated withBufferUtils.- Parameters:
capacity- the buffer capacity
-
create
public static VkBufferDeviceAddressCreateInfoEXT.Buffer create(long address, int capacity)
Create aVkBufferDeviceAddressCreateInfoEXT.Bufferinstance at the specified memory.- Parameters:
address- the memory addresscapacity- the buffer capacity
-
createSafe
@Nullable public static VkBufferDeviceAddressCreateInfoEXT.Buffer createSafe(long address, int capacity)
-
mallocStack
public static VkBufferDeviceAddressCreateInfoEXT mallocStack()
Returns a newVkBufferDeviceAddressCreateInfoEXTinstance allocated on the thread-localMemoryStack.
-
callocStack
public static VkBufferDeviceAddressCreateInfoEXT callocStack()
Returns a newVkBufferDeviceAddressCreateInfoEXTinstance allocated on the thread-localMemoryStackand initializes all its bits to zero.
-
mallocStack
public static VkBufferDeviceAddressCreateInfoEXT mallocStack(org.lwjgl.system.MemoryStack stack)
Returns a newVkBufferDeviceAddressCreateInfoEXTinstance allocated on the specifiedMemoryStack.- Parameters:
stack- the stack from which to allocate
-
callocStack
public static VkBufferDeviceAddressCreateInfoEXT callocStack(org.lwjgl.system.MemoryStack stack)
Returns a newVkBufferDeviceAddressCreateInfoEXTinstance allocated on the specifiedMemoryStackand initializes all its bits to zero.- Parameters:
stack- the stack from which to allocate
-
mallocStack
public static VkBufferDeviceAddressCreateInfoEXT.Buffer mallocStack(int capacity)
Returns a newVkBufferDeviceAddressCreateInfoEXT.Bufferinstance allocated on the thread-localMemoryStack.- Parameters:
capacity- the buffer capacity
-
callocStack
public static VkBufferDeviceAddressCreateInfoEXT.Buffer callocStack(int capacity)
Returns a newVkBufferDeviceAddressCreateInfoEXT.Bufferinstance allocated on the thread-localMemoryStackand initializes all its bits to zero.- Parameters:
capacity- the buffer capacity
-
mallocStack
public static VkBufferDeviceAddressCreateInfoEXT.Buffer mallocStack(int capacity, org.lwjgl.system.MemoryStack stack)
Returns a newVkBufferDeviceAddressCreateInfoEXT.Bufferinstance allocated on the specifiedMemoryStack.- Parameters:
stack- the stack from which to allocatecapacity- the buffer capacity
-
callocStack
public static VkBufferDeviceAddressCreateInfoEXT.Buffer callocStack(int capacity, org.lwjgl.system.MemoryStack stack)
Returns a newVkBufferDeviceAddressCreateInfoEXT.Bufferinstance allocated on the specifiedMemoryStackand initializes all its bits to zero.- Parameters:
stack- the stack from which to allocatecapacity- the buffer capacity
-
nsType
public static int nsType(long struct)
Unsafe version ofsType().
-
npNext
public static long npNext(long struct)
Unsafe version ofpNext().
-
ndeviceAddress
public static long ndeviceAddress(long struct)
Unsafe version ofdeviceAddress().
-
nsType
public static void nsType(long struct, int value)Unsafe version ofsType.
-
npNext
public static void npNext(long struct, long value)Unsafe version ofpNext.
-
ndeviceAddress
public static void ndeviceAddress(long struct, long value)Unsafe version ofdeviceAddress.
-
-