Method create_instance

samples/tooling/profiles/profiles.cpp:140–209

This sample overrides the instance creation part of the framework Instead of manually setting up all properties we use the Vulkan Profiles library to simplify instance setup

// This sample overrides the instance creation part of the framework
// Instead of manually setting up all properties we use the Vulkan Profiles library to simplify instance setup
std::unique_ptr<vkb::core::InstanceC> Profiles::create_instance()
{
	// Initialize Volk Vulkan Loader
	VkResult result = volkInitialize();
	if (result)
	{
		throw vkb::VulkanException(result, "Failed to initialize volk.");
	}

	// Check if the profile is supported at instance level
	VkBool32 profile_supported;
	vpGetInstanceProfileSupport(nullptr, &profile_properties, &profile_supported);
	if (!profile_supported)
	{
		throw std::runtime_error{"The selected profile is not supported (error at creating the instance)!"};
	}

	// Even when using profiles we still need to provide the platform specific get_surface() extension
	std::vector<const char *> enabled_extensions;
	enabled_extensions.push_back(VK_KHR_SURFACE_EXTENSION_NAME);

	for (const char *extension_name : window->get_required_surface_extensions())
	{
		enabled_extensions.push_back(extension_name);
	}

	VkInstanceCreateInfo create_info{};

#if (defined(VKB_ENABLE_PORTABILITY))
	enabled_extensions.push_back(VK_KHR_GET_PHYSICAL_DEVICE_PROPERTIES_2_EXTENSION_NAME);

	// Enumerate all instance extensions for the loader + driver to determine if VK_KHR_portability_enumeration is available
	uint32_t instance_extension_count;
	VK_CHECK(vkEnumerateInstanceExtensionProperties(nullptr, &instance_extension_count, nullptr));
	std::vector<VkExtensionProperties> available_instance_extensions(instance_extension_count);
	VK_CHECK(vkEnumerateInstanceExtensionProperties(nullptr, &instance_extension_count, available_instance_extensions.data()));

	// If VK_KHR_portability_enumeration is available in the implementation, then we must enable the extension
	if (std::ranges::any_of(available_instance_extensions,
	                        [](VkExtensionProperties const &extension) { return strcmp(extension.extensionName, VK_KHR_PORTABILITY_ENUMERATION_EXTENSION_NAME) == 0; }))
	{
		enabled_extensions.push_back(VK_KHR_PORTABILITY_ENUMERATION_EXTENSION_NAME);
		create_info.flags |= VK_INSTANCE_CREATE_ENUMERATE_PORTABILITY_BIT_KHR;
	}
#endif

	create_info.sType                   = VK_STRUCTURE_TYPE_INSTANCE_CREATE_INFO;
	create_info.ppEnabledExtensionNames = enabled_extensions.data();
	create_info.enabledExtensionCount   = static_cast<uint32_t>(enabled_extensions.size());
	// Note: We don't explicitly set an application info here so the one from the profile is used
	// This also defines the api version to be used

	// Create the instance using the profiles library
	VpInstanceCreateInfo instance_create_info{};
	instance_create_info.pEnabledFullProfiles    = &profile_properties;
	instance_create_info.enabledFullProfileCount = 1;
	instance_create_info.pCreateInfo             = &create_info;
	VkInstance vulkan_instance;