Class VkDeviceGroupDeviceCreateInfo

  • All Implemented Interfaces:
    java.lang.AutoCloseable, NativeResource, Pointer
    Direct Known Subclasses:
    VkDeviceGroupDeviceCreateInfoKHR

    public class VkDeviceGroupDeviceCreateInfo
    extends Struct
    implements NativeResource
    Create a logical device from multiple physical devices.
    Description

    The elements of the pPhysicalDevices array are an ordered list of the physical devices that the logical device represents. These must be a subset of a single device group, and need not be in the same order as they were enumerated. The order of the physical devices in the pPhysicalDevices array determines the device index of each physical device, with element i being assigned a device index of i. Certain commands and structures refer to one or more physical devices by using device indices or device masks formed using device indices.

    A logical device created without using VkDeviceGroupDeviceCreateInfo, or with physicalDeviceCount equal to zero, is equivalent to a physicalDeviceCount of one and pPhysicalDevices pointing to the physicalDevice parameter to CreateDevice. In particular, the device index of that physical device is zero.

    Valid Usage
    • Each element of pPhysicalDevices must be unique
    • All elements of pPhysicalDevices must be in the same device group as enumerated by EnumeratePhysicalDeviceGroups
    • If physicalDeviceCount is not 0, the physicalDevice parameter of CreateDevice must be an element of pPhysicalDevices.
    Valid Usage (Implicit)

    Member documentation

    • sType – the type of this structure.
    • pNextNULL or a pointer to an extension-specific structure.
    • physicalDeviceCount – the number of elements in the pPhysicalDevices array.
    • pPhysicalDevices – an array of physical device handles belonging to the same device group.

    Layout

    
     struct VkDeviceGroupDeviceCreateInfo {
         VkStructureType sType;
         void const * pNext;
         uint32_t physicalDeviceCount;
         VkPhysicalDevice const * pPhysicalDevices;
     }