java.lang.Object
- org.lwjgl.system.Pointer.Default
- - org.lwjgl.system.Struct
  - - org.lwjgl.vulkan.VkPhysicalDeviceIDProperties

All Implemented Interfaces:

java.lang.AutoCloseable, org.lwjgl.system.NativeResource, org.lwjgl.system.Pointer

Direct Known Subclasses:

VkPhysicalDeviceIDPropertiesKHR
```
public class VkPhysicalDeviceIDProperties
extends org.lwjgl.system.Struct
implements org.lwjgl.system.NativeResource
```
Structure specifying IDs related to the physical device.
Description

If the VkPhysicalDeviceIDProperties structure is included in the pNext chain of the VkPhysicalDeviceProperties2 structure passed to GetPhysicalDeviceProperties2, it is filled in with each corresponding implementation-dependent property.

deviceUUID must be immutable for a given device across instances, processes, driver APIs, driver versions, and system reboots.

Applications can compare the driverUUID value across instance and process boundaries, and can make similar queries in external APIs to determine whether they are capable of sharing memory objects and resources using them with the device.

deviceUUID and/or driverUUID must be used to determine whether a particular external object can be shared between driver components, where such a restriction exists as defined in the compatibility table for the particular object type:
If deviceLUIDValid is FALSE, the values of deviceLUID and deviceNodeMask are undefined. If deviceLUIDValid is TRUE and Vulkan is running on the Windows operating system, the contents of deviceLUID can be cast to an LUID object and must be equal to the locally unique identifier of a IDXGIAdapter1 object that corresponds to physicalDevice. If deviceLUIDValid is TRUE, deviceNodeMask must contain exactly one bit. If Vulkan is running on an operating system that supports the Direct3D 12 API and physicalDevice corresponds to an individual device in a linked device adapter, deviceNodeMask identifies the Direct3D 12 node corresponding to physicalDevice. Otherwise, deviceNodeMask must be 1.
Note

Although they have identical descriptions, VkPhysicalDeviceIDProperties::deviceUUID may differ from VkPhysicalDeviceProperties2::pipelineCacheUUID. The former is intended to identify and correlate devices across API and driver boundaries, while the latter is used to identify a compatible device and driver combination to use when serializing and de-serializing pipeline state.

Implementations should return deviceUUID values which are likely to be unique even in the presence of multiple Vulkan implementations (such as a GPU driver and a software renderer; two drivers for different GPUs; or the same Vulkan driver running on two logically different devices).

Khronos' conformance testing can not guarantee that deviceUUID values are actually unique, so implementors should make their own best efforts to ensure this. In particular, hard-coded deviceUUID values, especially all-0 bits, should never be used.

A combination of values unique to the vendor, the driver, and the hardware environment can be used to provide a deviceUUID which is unique to a high degree of certainty. Some possible inputs to such a computation are:
- Information reported by GetPhysicalDeviceProperties
- PCI device ID (if defined)
- PCI bus ID, or similar system configuration information.
- Driver binary checksums.
Note

While VkPhysicalDeviceIDProperties::deviceUUID is specified to remain consistent across driver versions and system reboots, it is not intended to be usable as a serializable persistent identifier for a device. It may change when a device is physically added to, removed from, or moved to a different connector in a system while that system is powered down. Further, there is no reasonable way to verify with conformance testing that a given device retains the same UUID in a given system across all driver versions supported in that system. While implementations should make every effort to report consistent device UUIDs across driver versions, applications should avoid relying on the persistence of this value for uses other than identifying compatible devices for external object sharing purposes.

Valid Usage (Implicit)
- sType must be STRUCTURE_TYPE_PHYSICAL_DEVICE_ID_PROPERTIES
Layout
```
 struct VkPhysicalDeviceIDProperties {
     VkStructureType sType();
     void * pNext();
     uint8_t deviceUUID()[VK_UUID_SIZE];
     uint8_t driverUUID()[VK_UUID_SIZE];
     uint8_t deviceLUID()[VK_LUID_SIZE];
     uint32_t deviceNodeMask();
     VkBool32 deviceLUIDValid();
 }
```

Nested Class Summary

Nested Classes
Modifier and Type Class Description

static class VkPhysicalDeviceIDProperties.Buffer
An array of VkPhysicalDeviceIDProperties structs.
- Nested classes/interfaces inherited from interface org.lwjgl.system.Pointer
  org.lwjgl.system.Pointer.Default
- Nested classes/interfaces inherited from class org.lwjgl.system.Struct
  org.lwjgl.system.Struct.StructValidation

Field Summary

Fields
Modifier and Type	Field	Description
`static int`	`ALIGNOF`	The struct alignment in bytes.
`static int`	`DEVICELUID DEVICELUIDVALID DEVICENODEMASK DEVICEUUID DRIVERUUID PNEXT`	The struct member offsets.
`static int`	`SIZEOF`	The struct size in bytes.
`static int`	`STYPE`	The struct member offsets.

Fields inherited from interface org.lwjgl.system.Pointer
BITS32, BITS64, CLONG_SHIFT, CLONG_SIZE, POINTER_SHIFT, POINTER_SIZE

Constructor Summary

Constructors
Constructor	Description
`VkPhysicalDeviceIDProperties(java.nio.ByteBuffer container)`	Creates a `VkPhysicalDeviceIDProperties` instance at the current position of the specified `ByteBuffer` container.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method	Description
`static VkPhysicalDeviceIDProperties`	`calloc()`	Returns a new `VkPhysicalDeviceIDProperties` instance allocated with `memCalloc`.
`static VkPhysicalDeviceIDProperties.Buffer`	`calloc(int capacity)`	Returns a new `VkPhysicalDeviceIDProperties.Buffer` instance allocated with `memCalloc`.
`static VkPhysicalDeviceIDProperties.Buffer`	`calloc(int capacity, org.lwjgl.system.MemoryStack stack)`	Returns a new `VkPhysicalDeviceIDProperties.Buffer` instance allocated on the specified `MemoryStack` and initializes all its bits to zero.
`static VkPhysicalDeviceIDProperties`	`calloc(org.lwjgl.system.MemoryStack stack)`	Returns a new `VkPhysicalDeviceIDProperties` instance allocated on the specified `MemoryStack` and initializes all its bits to zero.
`static VkPhysicalDeviceIDProperties`	`callocStack()`	Deprecated.
`static VkPhysicalDeviceIDProperties.Buffer`	`callocStack(int capacity)`	Deprecated.
`static VkPhysicalDeviceIDProperties.Buffer`	`callocStack(int capacity, org.lwjgl.system.MemoryStack stack)`	Deprecated.
`static VkPhysicalDeviceIDProperties`	`callocStack(org.lwjgl.system.MemoryStack stack)`	Deprecated.
`static VkPhysicalDeviceIDProperties`	`create()`	Returns a new `VkPhysicalDeviceIDProperties` instance allocated with `BufferUtils`.
`static VkPhysicalDeviceIDProperties.Buffer`	`create(int capacity)`	Returns a new `VkPhysicalDeviceIDProperties.Buffer` instance allocated with `BufferUtils`.
`static VkPhysicalDeviceIDProperties`	`create(long address)`	Returns a new `VkPhysicalDeviceIDProperties` instance for the specified memory address.
`static VkPhysicalDeviceIDProperties.Buffer`	`create(long address, int capacity)`	Create a `VkPhysicalDeviceIDProperties.Buffer` instance at the specified memory.
`static VkPhysicalDeviceIDProperties`	`createSafe(long address)`	Like `create`, but returns `null` if `address` is `NULL`.
`static VkPhysicalDeviceIDProperties.Buffer`	`createSafe(long address, int capacity)`	Like `create`, but returns `null` if `address` is `NULL`.
`java.nio.ByteBuffer`	`deviceLUID()`	an array of `LUID_SIZE` `uint8_t` values representing a locally unique identifier for the device.
`byte`	`deviceLUID(int index)`	an array of `LUID_SIZE` `uint8_t` values representing a locally unique identifier for the device.
`boolean`	`deviceLUIDValid()`	a boolean value that will be `TRUE` if `deviceLUID` contains a valid LUID and `deviceNodeMask` contains a valid node mask, and `FALSE` if they do not.
`int`	`deviceNodeMask()`	a `uint32_t` bitfield identifying the node within a linked device adapter corresponding to the device.
`java.nio.ByteBuffer`	`deviceUUID()`	an array of `UUID_SIZE` `uint8_t` values representing a universally unique identifier for the device.
`byte`	`deviceUUID(int index)`	an array of `UUID_SIZE` `uint8_t` values representing a universally unique identifier for the device.
`java.nio.ByteBuffer`	`driverUUID()`	an array of `UUID_SIZE` `uint8_t` values representing a universally unique identifier for the driver build in use by the device.
`byte`	`driverUUID(int index)`	an array of `UUID_SIZE` `uint8_t` values representing a universally unique identifier for the driver build in use by the device.
`static VkPhysicalDeviceIDProperties`	`malloc()`	Returns a new `VkPhysicalDeviceIDProperties` instance allocated with `memAlloc`.
`static VkPhysicalDeviceIDProperties.Buffer`	`malloc(int capacity)`	Returns a new `VkPhysicalDeviceIDProperties.Buffer` instance allocated with `memAlloc`.
`static VkPhysicalDeviceIDProperties.Buffer`	`malloc(int capacity, org.lwjgl.system.MemoryStack stack)`	Returns a new `VkPhysicalDeviceIDProperties.Buffer` instance allocated on the specified `MemoryStack`.
`static VkPhysicalDeviceIDProperties`	`malloc(org.lwjgl.system.MemoryStack stack)`	Returns a new `VkPhysicalDeviceIDProperties` instance allocated on the specified `MemoryStack`.
`static VkPhysicalDeviceIDProperties`	`mallocStack()`	Deprecated.
`static VkPhysicalDeviceIDProperties.Buffer`	`mallocStack(int capacity)`	Deprecated.
`static VkPhysicalDeviceIDProperties.Buffer`	`mallocStack(int capacity, org.lwjgl.system.MemoryStack stack)`	Deprecated.
`static VkPhysicalDeviceIDProperties`	`mallocStack(org.lwjgl.system.MemoryStack stack)`	Deprecated.
`static java.nio.ByteBuffer`	`ndeviceLUID(long struct)`	Unsafe version of `deviceLUID()`.
`static byte`	`ndeviceLUID(long struct, int index)`	Unsafe version of `deviceLUID`.
`static int`	`ndeviceLUIDValid(long struct)`	Unsafe version of `deviceLUIDValid()`.
`static int`	`ndeviceNodeMask(long struct)`	Unsafe version of `deviceNodeMask()`.
`static java.nio.ByteBuffer`	`ndeviceUUID(long struct)`	Unsafe version of `deviceUUID()`.
`static byte`	`ndeviceUUID(long struct, int index)`	Unsafe version of `deviceUUID`.
`static java.nio.ByteBuffer`	`ndriverUUID(long struct)`	Unsafe version of `driverUUID()`.
`static byte`	`ndriverUUID(long struct, int index)`	Unsafe version of `driverUUID`.
`static long`	`npNext(long struct)`	Unsafe version of `pNext()`.
`static void`	`npNext(long struct, long value)`	Unsafe version of `pNext`.
`static int`	`nsType(long struct)`	Unsafe version of `sType()`.
`static void`	`nsType(long struct, int value)`	Unsafe version of `sType`.
`long`	`pNext()`	`NULL` or a pointer to a structure extending this structure.
`VkPhysicalDeviceIDProperties`	`pNext(long value)`	Sets the specified value to the `pNext()` field.
`VkPhysicalDeviceIDProperties`	`set(int sType, long pNext)`	Initializes this struct with the specified values.
`VkPhysicalDeviceIDProperties`	`set(VkPhysicalDeviceIDProperties src)`	Copies the specified struct data to this struct.
`int`	`sizeof()`
`int`	`sType()`	the type of this structure.
`VkPhysicalDeviceIDProperties`	`sType(int value)`	Sets the specified value to the `sType()` field.
`VkPhysicalDeviceIDProperties`	`sType$Default()`	Sets the `STRUCTURE_TYPE_PHYSICAL_DEVICE_ID_PROPERTIES` value to the `sType()` field.

Methods inherited from interface org.lwjgl.system.NativeResource
close, free

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

Methods inherited from class org.lwjgl.system.Pointer.Default
address, equals, hashCode, toString

Methods inherited from class org.lwjgl.system.Struct
clear, free, isNull, validate

- Field Detail
  - SIZEOF
    
    The struct size in bytes.
  - ALIGNOF
    
    The struct alignment in bytes.
  - STYPE, PNEXT, DEVICEUUID, DRIVERUUID, DEVICELUID, DEVICENODEMASK, DEVICELUIDVALID
    
    The struct member offsets.
- Constructor Detail
  - VkPhysicalDeviceIDProperties
```
public VkPhysicalDeviceIDProperties(java.nio.ByteBuffer container)
```
    Creates a VkPhysicalDeviceIDProperties 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 Detail
  - sizeof
```
public int sizeof()
```
    Specified by:
    
    sizeof in class org.lwjgl.system.Struct
  - sType
```
public int sType()
```
    the type of this structure.
  - pNext
```
public long pNext()
```
    NULL or a pointer to a structure extending this structure.
  - deviceUUID
```
public java.nio.ByteBuffer deviceUUID()

public byte deviceUUID(int index)
```
    an array of UUID_SIZE uint8_t values representing a universally unique identifier for the device.
  - driverUUID
```
public java.nio.ByteBuffer driverUUID()

public byte driverUUID(int index)
```
    an array of UUID_SIZE uint8_t values representing a universally unique identifier for the driver build in use by the device.
  - deviceLUID
```
public java.nio.ByteBuffer deviceLUID()

public byte deviceLUID(int index)
```
    an array of LUID_SIZE uint8_t values representing a locally unique identifier for the device.
  - deviceNodeMask
```
public int deviceNodeMask()
```
    a uint32_t bitfield identifying the node within a linked device adapter corresponding to the device.
  - deviceLUIDValid
```
public boolean deviceLUIDValid()
```
    a boolean value that will be TRUE if deviceLUID contains a valid LUID and deviceNodeMask contains a valid node mask, and FALSE if they do not.
  - sType
```
public VkPhysicalDeviceIDProperties sType(int value)
```
    Sets the specified value to the sType() field.
  - sType$Default
```
public VkPhysicalDeviceIDProperties sType$Default()
```
    Sets the STRUCTURE_TYPE_PHYSICAL_DEVICE_ID_PROPERTIES value to the sType() field.
  - pNext
```
public VkPhysicalDeviceIDProperties pNext(long value)
```
    Sets the specified value to the pNext() field.
  - set
```
public VkPhysicalDeviceIDProperties set(int sType,
                                        long pNext)
```
    Initializes this struct with the specified values.
  - set
```
public VkPhysicalDeviceIDProperties set(VkPhysicalDeviceIDProperties src)
```
    Copies the specified struct data to this struct.
    
    Parameters:
    
    src - the source struct
    
    Returns:
    
    this struct
  - malloc
```
public static VkPhysicalDeviceIDProperties malloc()
```
    Returns a new VkPhysicalDeviceIDProperties instance allocated with memAlloc. The instance must be explicitly freed.
  - calloc
```
public static VkPhysicalDeviceIDProperties calloc()
```
    Returns a new VkPhysicalDeviceIDProperties instance allocated with memCalloc. The instance must be explicitly freed.
  - create
```
public static VkPhysicalDeviceIDProperties create()
```
    Returns a new VkPhysicalDeviceIDProperties instance allocated with BufferUtils.
  - create
```
public static VkPhysicalDeviceIDProperties create(long address)
```
    Returns a new VkPhysicalDeviceIDProperties instance for the specified memory address.
  - createSafe
```
@Nullable
public static VkPhysicalDeviceIDProperties createSafe(long address)
```
    Like create, but returns null if address is NULL.
  - malloc
```
public static VkPhysicalDeviceIDProperties.Buffer malloc(int capacity)
```
    Returns a new VkPhysicalDeviceIDProperties.Buffer instance allocated with memAlloc. The instance must be explicitly freed.
    
    Parameters:
    
    capacity - the buffer capacity
  - calloc
```
public static VkPhysicalDeviceIDProperties.Buffer calloc(int capacity)
```
    Returns a new VkPhysicalDeviceIDProperties.Buffer instance allocated with memCalloc. The instance must be explicitly freed.
    
    Parameters:
    
    capacity - the buffer capacity
  - create
```
public static VkPhysicalDeviceIDProperties.Buffer create(int capacity)
```
    Returns a new VkPhysicalDeviceIDProperties.Buffer instance allocated with BufferUtils.
    
    Parameters:
    
    capacity - the buffer capacity
  - create
```
public static VkPhysicalDeviceIDProperties.Buffer create(long address,
                                                         int capacity)
```
    Create a VkPhysicalDeviceIDProperties.Buffer instance at the specified memory.
    
    Parameters:
    
    address - the memory address
    
    capacity - the buffer capacity
  - createSafe
```
@Nullable
public static VkPhysicalDeviceIDProperties.Buffer createSafe(long address,
                                                             int capacity)
```
    Like create, but returns null if address is NULL.
  - mallocStack
```
@Deprecated
public static VkPhysicalDeviceIDProperties mallocStack()
```
    Deprecated.
    
    Deprecated for removal in 3.4.0. Use malloc(MemoryStack) instead.
  - callocStack
```
@Deprecated
public static VkPhysicalDeviceIDProperties callocStack()
```
    Deprecated.
    
    Deprecated for removal in 3.4.0. Use calloc(MemoryStack) instead.
  - mallocStack
```
@Deprecated
public static VkPhysicalDeviceIDProperties mallocStack(org.lwjgl.system.MemoryStack stack)
```
    Deprecated.
    
    Deprecated for removal in 3.4.0. Use malloc(MemoryStack) instead.
  - callocStack
```
@Deprecated
public static VkPhysicalDeviceIDProperties callocStack(org.lwjgl.system.MemoryStack stack)
```
    Deprecated.
    
    Deprecated for removal in 3.4.0. Use calloc(MemoryStack) instead.
  - mallocStack
```
@Deprecated
public static VkPhysicalDeviceIDProperties.Buffer mallocStack(int capacity)
```
    Deprecated.
    
    Deprecated for removal in 3.4.0. Use malloc(int, MemoryStack) instead.
  - callocStack
```
@Deprecated
public static VkPhysicalDeviceIDProperties.Buffer callocStack(int capacity)
```
    Deprecated.
    
    Deprecated for removal in 3.4.0. Use calloc(int, MemoryStack) instead.
  - mallocStack
```
@Deprecated
public static VkPhysicalDeviceIDProperties.Buffer mallocStack(int capacity,
                                                              org.lwjgl.system.MemoryStack stack)
```
    Deprecated.
    
    Deprecated for removal in 3.4.0. Use malloc(int, MemoryStack) instead.
  - callocStack
```
@Deprecated
public static VkPhysicalDeviceIDProperties.Buffer callocStack(int capacity,
                                                              org.lwjgl.system.MemoryStack stack)
```
    Deprecated.
    
    Deprecated for removal in 3.4.0. Use calloc(int, MemoryStack) instead.
  - malloc
```
public static VkPhysicalDeviceIDProperties malloc(org.lwjgl.system.MemoryStack stack)
```
    Returns a new VkPhysicalDeviceIDProperties instance allocated on the specified MemoryStack.
    
    Parameters:
    
    stack - the stack from which to allocate
  - calloc
```
public static VkPhysicalDeviceIDProperties calloc(org.lwjgl.system.MemoryStack stack)
```
    Returns a new VkPhysicalDeviceIDProperties instance allocated on the specified MemoryStack and initializes all its bits to zero.
    
    Parameters:
    
    stack - the stack from which to allocate
  - malloc
```
public static VkPhysicalDeviceIDProperties.Buffer malloc(int capacity,
                                                         org.lwjgl.system.MemoryStack stack)
```
    Returns a new VkPhysicalDeviceIDProperties.Buffer instance allocated on the specified MemoryStack.
    
    Parameters:
    
    stack - the stack from which to allocate
    
    capacity - the buffer capacity
  - calloc
```
public static VkPhysicalDeviceIDProperties.Buffer calloc(int capacity,
                                                         org.lwjgl.system.MemoryStack stack)
```
    Returns a new VkPhysicalDeviceIDProperties.Buffer instance allocated on the specified MemoryStack and initializes all its bits to zero.
    
    Parameters:
    
    stack - the stack from which to allocate
    
    capacity - the buffer capacity
  - nsType
```
public static int nsType(long struct)
```
    Unsafe version of sType().
  - npNext
```
public static long npNext(long struct)
```
    Unsafe version of pNext().
  - ndeviceUUID
```
public static java.nio.ByteBuffer ndeviceUUID(long struct)
```
    Unsafe version of deviceUUID().
  - ndeviceUUID
```
public static byte ndeviceUUID(long struct,
                               int index)
```
    Unsafe version of deviceUUID.
  - ndriverUUID
```
public static java.nio.ByteBuffer ndriverUUID(long struct)
```
    Unsafe version of driverUUID().
  - ndriverUUID
```
public static byte ndriverUUID(long struct,
                               int index)
```
    Unsafe version of driverUUID.
  - ndeviceLUID
```
public static java.nio.ByteBuffer ndeviceLUID(long struct)
```
    Unsafe version of deviceLUID().
  - ndeviceLUID
```
public static byte ndeviceLUID(long struct,
                               int index)
```
    Unsafe version of deviceLUID.
  - ndeviceNodeMask
```
public static int ndeviceNodeMask(long struct)
```
    Unsafe version of deviceNodeMask().
  - ndeviceLUIDValid
```
public static int ndeviceLUIDValid(long struct)
```
    Unsafe version of deviceLUIDValid().
  - nsType
```
public static void nsType(long struct,
                          int value)
```
    Unsafe version of sType.
  - npNext
```
public static void npNext(long struct,
                          long value)
```
    Unsafe version of pNext.

Class VkPhysicalDeviceIDProperties

Description

Note

Note

Valid Usage (Implicit)

Layout

Nested Class Summary

Nested classes/interfaces inherited from interface org.lwjgl.system.Pointer

Nested classes/interfaces inherited from class org.lwjgl.system.Struct

Field Summary

Fields inherited from interface org.lwjgl.system.Pointer

Constructor Summary

Method Summary

Methods inherited from interface org.lwjgl.system.NativeResource

Methods inherited from class java.lang.Object

Methods inherited from class org.lwjgl.system.Pointer.Default

Methods inherited from class org.lwjgl.system.Struct

Field Detail

SIZEOF

ALIGNOF

STYPE, PNEXT, DEVICEUUID, DRIVERUUID, DEVICELUID, DEVICENODEMASK, DEVICELUIDVALID

Constructor Detail

VkPhysicalDeviceIDProperties

Method Detail

sizeof

sType

pNext

deviceUUID

driverUUID

deviceLUID

deviceNodeMask

deviceLUIDValid

sType

sType$Default

pNext

set

set

malloc

calloc

create

create

createSafe

malloc

calloc

create

create

createSafe

mallocStack

callocStack

mallocStack

callocStack

mallocStack

callocStack

mallocStack

callocStack

malloc

calloc

malloc

calloc

nsType

npNext

ndeviceUUID

ndeviceUUID

ndriverUUID

ndriverUUID

ndeviceLUID

ndeviceLUID

ndeviceNodeMask

ndeviceLUIDValid

nsType

npNext