Package org.lwjgl.vulkan

Class VkDeviceFaultAddressInfoEXT

java.lang.Object
org.lwjgl.system.Pointer.Default
org.lwjgl.system.Struct<VkDeviceFaultAddressInfoEXT>
org.lwjgl.vulkan.VkDeviceFaultAddressInfoEXT
All Implemented Interfaces:
AutoCloseable, org.lwjgl.system.NativeResource, org.lwjgl.system.Pointer
public class VkDeviceFaultAddressInfoEXT extends org.lwjgl.system.Struct<VkDeviceFaultAddressInfoEXT> implements org.lwjgl.system.NativeResource
Structure specifying GPU virtual address information.
Description

The combination of reportedAddress and addressPrecision allow the possible range of addresses to be calculated, such that:


 lower_address = (pInfo->reportedAddress & ~(pInfo->addressPrecision-1))
 upper_address = (pInfo->reportedAddress |  (pInfo->addressPrecision-1))
Note

It is valid for the reportedAddress to contain a more precise address than indicated by addressPrecision. In this case, the value of reportedAddress should be treated as an additional hint as to the value of the address that triggered the page fault, or to the value of an instruction pointer.

Valid Usage (Implicit)
  • addressType must be a valid VkDeviceFaultAddressTypeEXT value
See Also

VkDeviceFaultInfoEXT

Layout


 struct VkDeviceFaultAddressInfoEXT {
     VkDeviceFaultAddressTypeEXT addressType();
     VkDeviceAddress reportedAddress();
     VkDeviceSize addressPrecision();
 }

  • Field Details

    • SIZEOF

      public static final int SIZEOF
      The struct size in bytes.

    • ALIGNOF

      public static final int ALIGNOF
      The struct alignment in bytes.

    • ADDRESSTYPE

      public static final int ADDRESSTYPE
      The struct member offsets.

    • REPORTEDADDRESS

      public static final int REPORTEDADDRESS
      The struct member offsets.

    • ADDRESSPRECISION

      public static final int ADDRESSPRECISION
      The struct member offsets.

  • Constructor Details

    • VkDeviceFaultAddressInfoEXT

      public VkDeviceFaultAddressInfoEXT(ByteBuffer container)
      Creates a VkDeviceFaultAddressInfoEXT instance at the current position of the specified ByteBuffer 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()
      Specified by:
      sizeof in class org.lwjgl.system.Struct<VkDeviceFaultAddressInfoEXT>

    • addressType

      public int addressType()
      either the type of memory operation that triggered a page fault, or the type of association between an instruction pointer and a fault.

    • reportedAddress

      public long reportedAddress()
      the GPU virtual address recorded by the device.

    • addressPrecision

      public long addressPrecision()
      a power of two value that specifies how precisely the device can report the address.

    • addressType

      public VkDeviceFaultAddressInfoEXT addressType(int value)
      Sets the specified value to the addressType() field.

    • reportedAddress

      public VkDeviceFaultAddressInfoEXT reportedAddress(long value)
      Sets the specified value to the reportedAddress() field.

    • addressPrecision

      public VkDeviceFaultAddressInfoEXT addressPrecision(long value)
      Sets the specified value to the addressPrecision() field.

    • set

      public VkDeviceFaultAddressInfoEXT set(int addressType, long reportedAddress, long addressPrecision)
      Initializes this struct with the specified values.

    • set

      public VkDeviceFaultAddressInfoEXT set(VkDeviceFaultAddressInfoEXT src)
      Copies the specified struct data to this struct.
      Parameters:
      src - the source struct
      Returns:
      this struct

    • malloc

      public static VkDeviceFaultAddressInfoEXT malloc()
      Returns a new VkDeviceFaultAddressInfoEXT instance allocated with memAlloc. The instance must be explicitly freed.

    • calloc

      public static VkDeviceFaultAddressInfoEXT calloc()
      Returns a new VkDeviceFaultAddressInfoEXT instance allocated with memCalloc. The instance must be explicitly freed.

    • create

      public static VkDeviceFaultAddressInfoEXT create()
      Returns a new VkDeviceFaultAddressInfoEXT instance allocated with BufferUtils.

    • create

      public static VkDeviceFaultAddressInfoEXT create(long address)
      Returns a new VkDeviceFaultAddressInfoEXT instance for the specified memory address.

    • createSafe

      public static @Nullable VkDeviceFaultAddressInfoEXT createSafe(long address)
      Like create, but returns null if address is NULL.

    • malloc

      public static VkDeviceFaultAddressInfoEXT.Buffer malloc(int capacity)
      Returns a new VkDeviceFaultAddressInfoEXT.Buffer instance allocated with memAlloc. The instance must be explicitly freed.
      Parameters:
      capacity - the buffer capacity

    • calloc

      public static VkDeviceFaultAddressInfoEXT.Buffer calloc(int capacity)
      Returns a new VkDeviceFaultAddressInfoEXT.Buffer instance allocated with memCalloc. The instance must be explicitly freed.
      Parameters:
      capacity - the buffer capacity

    • create

      public static VkDeviceFaultAddressInfoEXT.Buffer create(int capacity)
      Returns a new VkDeviceFaultAddressInfoEXT.Buffer instance allocated with BufferUtils.
      Parameters:
      capacity - the buffer capacity

    • create

      public static VkDeviceFaultAddressInfoEXT.Buffer create(long address, int capacity)
      Create a VkDeviceFaultAddressInfoEXT.Buffer instance at the specified memory.
      Parameters:
      address - the memory address
      capacity - the buffer capacity

    • createSafe

      public static @Nullable VkDeviceFaultAddressInfoEXT.Buffer createSafe(long address, int capacity)
      Like create, but returns null if address is NULL.

    • malloc

      public static VkDeviceFaultAddressInfoEXT malloc(org.lwjgl.system.MemoryStack stack)
      Returns a new VkDeviceFaultAddressInfoEXT instance allocated on the specified MemoryStack.
      Parameters:
      stack - the stack from which to allocate

    • calloc

      public static VkDeviceFaultAddressInfoEXT calloc(org.lwjgl.system.MemoryStack stack)
      Returns a new VkDeviceFaultAddressInfoEXT instance allocated on the specified MemoryStack and initializes all its bits to zero.
      Parameters:
      stack - the stack from which to allocate

    • malloc

      public static VkDeviceFaultAddressInfoEXT.Buffer malloc(int capacity, org.lwjgl.system.MemoryStack stack)
      Returns a new VkDeviceFaultAddressInfoEXT.Buffer instance allocated on the specified MemoryStack.
      Parameters:
      capacity - the buffer capacity
      stack - the stack from which to allocate

    • calloc

      public static VkDeviceFaultAddressInfoEXT.Buffer calloc(int capacity, org.lwjgl.system.MemoryStack stack)
      Returns a new VkDeviceFaultAddressInfoEXT.Buffer instance allocated on the specified MemoryStack and initializes all its bits to zero.
      Parameters:
      capacity - the buffer capacity
      stack - the stack from which to allocate

    • naddressType

      public static int naddressType(long struct)
      Unsafe version of addressType().

    • nreportedAddress

      public static long nreportedAddress(long struct)
      Unsafe version of reportedAddress().

    • naddressPrecision

      public static long naddressPrecision(long struct)
      Unsafe version of addressPrecision().

    • naddressType

      public static void naddressType(long struct, int value)
      Unsafe version of addressType.

    • nreportedAddress

      public static void nreportedAddress(long struct, long value)
      Unsafe version of reportedAddress.

    • naddressPrecision

      public static void naddressPrecision(long struct, long value)
      Unsafe version of addressPrecision.