To retrieve a list of physical device objects representing the physical devices installed in the system, call:
// Provided by VK_VERSION_1_0 VkResult vkEnumeratePhysicalDevices( VkInstance instance, uint32_t* pPhysicalDeviceCount, VkPhysicalDevice* pPhysicalDevices);
instanceis a handle to a Vulkan instance previously created with vkCreateInstance.
pPhysicalDeviceCountis a pointer to an integer related to the number of physical devices available or queried, as described below.
NULLor a pointer to an array of
NULL, then the number of physical devices
available is returned in
pPhysicalDeviceCount must point to a variable set by the
user to the number of elements in the
pPhysicalDevices array, and on
return the variable is overwritten with the number of handles actually
pPhysicalDeviceCount is less than the number of physical devices
available, at most
pPhysicalDeviceCount structures will be written.
pPhysicalDeviceCount is smaller than the number of physical devices
VK_INCOMPLETE will be returned instead of
to indicate that not all the available physical devices were returned.
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.