To retrieve a list of the device groups present in the system, call:
VkResult vkEnumeratePhysicalDeviceGroups( VkInstance instance, uint32_t* pPhysicalDeviceGroupCount, VkPhysicalDeviceGroupProperties* pPhysicalDeviceGroupProperties);
or the equivalent command
VkResult vkEnumeratePhysicalDeviceGroupsKHR( VkInstance instance, uint32_t* pPhysicalDeviceGroupCount, VkPhysicalDeviceGroupProperties* pPhysicalDeviceGroupProperties);
instanceis a handle to a Vulkan instance previously created with vkCreateInstance.
pPhysicalDeviceGroupCountis a pointer to an integer related to the number of device groups available or queried, as described below.
NULLor a pointer to an array of VkPhysicalDeviceGroupProperties structures.
NULL, then the number of device
groups available is returned in
pPhysicalDeviceGroupCount must point to a variable set by
the user to the number of elements in the
pPhysicalDeviceGroupProperties array, and on return the variable is
overwritten with the number of structures actually written to
pPhysicalDeviceGroupCount is less than the number of device groups
available, at most
pPhysicalDeviceGroupCount structures will be
pPhysicalDeviceGroupCount is smaller than the number of device
VK_INCOMPLETE will be returned instead of
VK_SUCCESS, to indicate that not all the available device groups were
Every physical device must be in exactly one device group.
For more information, see the Vulkan Specification
This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.
Copyright (c) 2014-2020 Khronos Group. This work is licensed under a Creative Commons Attribution 4.0 International License.