/* * Copyright (c) 2016-2021 Arm Limited. * * SPDX-License-Identifier: MIT * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to * deal in the Software without restriction, including without limitation the * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or * sell copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all * copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE * SOFTWARE. */ #include #include #include #include #include "private_data.hpp" #include "surface_api.hpp" #include "swapchain_api.hpp" #include "util/extension_list.hpp" #include "util/custom_allocator.hpp" #include "wsi/wsi_factory.hpp" #include "util/log.hpp" #define VK_LAYER_API_VERSION VK_MAKE_VERSION(1, 0, VK_HEADER_VERSION) namespace layer { static const VkLayerProperties global_layer = { "VK_LAYER_window_system_integration", VK_LAYER_API_VERSION, 1, "Window system integration layer", }; static const VkExtensionProperties device_extension[] = { { VK_KHR_SWAPCHAIN_EXTENSION_NAME, VK_KHR_SWAPCHAIN_SPEC_VERSION } }; static const VkExtensionProperties instance_extension[] = { { VK_KHR_SURFACE_EXTENSION_NAME, VK_KHR_SURFACE_SPEC_VERSION } }; VKAPI_ATTR VkResult extension_properties(const uint32_t count, const VkExtensionProperties *layer_ext, uint32_t *pCount, VkExtensionProperties *pProp) { uint32_t size; if (pProp == NULL || layer_ext == NULL) { *pCount = count; return VK_SUCCESS; } size = *pCount < count ? *pCount : count; memcpy(pProp, layer_ext, size * sizeof(*pProp)); *pCount = size; if (size < count) { return VK_INCOMPLETE; } return VK_SUCCESS; } VKAPI_ATTR VkResult layer_properties(const uint32_t count, const VkLayerProperties *layer_prop, uint32_t *pCount, VkLayerProperties *pProp) { uint32_t size; if (pProp == NULL || layer_prop == NULL) { *pCount = count; return VK_SUCCESS; } size = *pCount < count ? *pCount : count; memcpy(pProp, layer_prop, size * sizeof(*pProp)); *pCount = size; if (size < count) { return VK_INCOMPLETE; } return VK_SUCCESS; } VKAPI_ATTR VkLayerInstanceCreateInfo *get_chain_info(const VkInstanceCreateInfo *pCreateInfo, VkLayerFunction func) { VkLayerInstanceCreateInfo *chain_info = (VkLayerInstanceCreateInfo *)pCreateInfo->pNext; while (chain_info && !(chain_info->sType == VK_STRUCTURE_TYPE_LOADER_INSTANCE_CREATE_INFO && chain_info->function == func)) { chain_info = (VkLayerInstanceCreateInfo *)chain_info->pNext; } return chain_info; } VKAPI_ATTR VkLayerDeviceCreateInfo *get_chain_info(const VkDeviceCreateInfo *pCreateInfo, VkLayerFunction func) { VkLayerDeviceCreateInfo *chain_info = (VkLayerDeviceCreateInfo *)pCreateInfo->pNext; while (chain_info && !(chain_info->sType == VK_STRUCTURE_TYPE_LOADER_DEVICE_CREATE_INFO && chain_info->function == func)) { chain_info = (VkLayerDeviceCreateInfo *)chain_info->pNext; } return chain_info; } template static T get_instance_proc_addr(PFN_vkGetInstanceProcAddr fp_get_instance_proc_addr, const char *name, VkInstance instance = VK_NULL_HANDLE) { T func = reinterpret_cast(fp_get_instance_proc_addr(instance, name)); if (func == nullptr) { WSI_LOG_WARNING("Failed to get address of %s", name); } return func; } /* This is where the layer is initialised and the instance dispatch table is constructed. */ VKAPI_ATTR VkResult create_instance(const VkInstanceCreateInfo *pCreateInfo, const VkAllocationCallbacks *pAllocator, VkInstance *pInstance) { VkLayerInstanceCreateInfo *layerCreateInfo = get_chain_info(pCreateInfo, VK_LAYER_LINK_INFO); PFN_vkSetInstanceLoaderData loader_callback = get_chain_info(pCreateInfo, VK_LOADER_DATA_CALLBACK)->u.pfnSetInstanceLoaderData; if (nullptr == layerCreateInfo || nullptr == layerCreateInfo->u.pLayerInfo) { return VK_ERROR_INITIALIZATION_FAILED; } PFN_vkGetInstanceProcAddr fpGetInstanceProcAddr = layerCreateInfo->u.pLayerInfo->pfnNextGetInstanceProcAddr; auto fpCreateInstance = get_instance_proc_addr(fpGetInstanceProcAddr, "vkCreateInstance"); if (nullptr == fpCreateInstance) { return VK_ERROR_INITIALIZATION_FAILED; } /* Advance the link info for the next element on the chain. */ layerCreateInfo->u.pLayerInfo = layerCreateInfo->u.pLayerInfo->pNext; /* The layer needs some Vulkan 1.1 functionality in order to operate correctly. * We thus change the application info to require this API version, if necessary. * This may have consequences for ICDs whose behaviour depends on apiVersion. */ const uint32_t minimum_required_vulkan_version = VK_API_VERSION_1_1; VkApplicationInfo modified_app_info{}; if (nullptr != pCreateInfo->pApplicationInfo) { modified_app_info = *pCreateInfo->pApplicationInfo; if (modified_app_info.apiVersion < minimum_required_vulkan_version) { modified_app_info.apiVersion = minimum_required_vulkan_version; } } else { modified_app_info.sType = VK_STRUCTURE_TYPE_APPLICATION_INFO; modified_app_info.apiVersion = minimum_required_vulkan_version; } VkInstanceCreateInfo modified_info = *pCreateInfo; modified_info.pApplicationInfo = &modified_app_info; /* Now call create instance on the chain further down the list. * Note that we do not remove the extensions that the layer supports from modified_info.ppEnabledExtensionNames. * Layers have to abide the rule that vkCreateInstance must not generate an error for unrecognized extension names. * Also, the loader filters the extension list to ensure that ICDs do not see extensions that they do not support. */ VkResult result; result = fpCreateInstance(&modified_info, pAllocator, pInstance); if (result != VK_SUCCESS) { return result; } instance_dispatch_table table{}; result = table.populate(*pInstance, fpGetInstanceProcAddr); if (result != VK_SUCCESS) { if (table.DestroyInstance != nullptr) { table.DestroyInstance(*pInstance, pAllocator); } return result; } /* Find all the platforms that the layer can handle based on pCreateInfo->ppEnabledExtensionNames. */ auto layer_platforms_to_enable = wsi::find_enabled_layer_platforms(pCreateInfo); /* Following the spec: use the callbacks provided to vkCreateInstance() if not nullptr, * otherwise use the default callbacks. */ util::allocator instance_allocator{ VK_SYSTEM_ALLOCATION_SCOPE_INSTANCE, pAllocator }; result = instance_private_data::associate(*pInstance, table, loader_callback, layer_platforms_to_enable, instance_allocator); if (result != VK_SUCCESS) { if (table.DestroyInstance != nullptr) { table.DestroyInstance(*pInstance, pAllocator); } } return result; } VKAPI_ATTR VkResult create_device(VkPhysicalDevice physicalDevice, const VkDeviceCreateInfo *pCreateInfo, const VkAllocationCallbacks *pAllocator, VkDevice *pDevice) { VkLayerDeviceCreateInfo *layerCreateInfo = get_chain_info(pCreateInfo, VK_LAYER_LINK_INFO); PFN_vkSetDeviceLoaderData loader_callback = get_chain_info(pCreateInfo, VK_LOADER_DATA_CALLBACK)->u.pfnSetDeviceLoaderData; if (nullptr == layerCreateInfo || nullptr == layerCreateInfo->u.pLayerInfo) { return VK_ERROR_INITIALIZATION_FAILED; } /* Retrieve the vkGetDeviceProcAddr and the vkCreateDevice function pointers for the next layer in the chain. */ PFN_vkGetInstanceProcAddr fpGetInstanceProcAddr = layerCreateInfo->u.pLayerInfo->pfnNextGetInstanceProcAddr; PFN_vkGetDeviceProcAddr fpGetDeviceProcAddr = layerCreateInfo->u.pLayerInfo->pfnNextGetDeviceProcAddr; auto fpCreateDevice = get_instance_proc_addr(fpGetInstanceProcAddr, "vkCreateDevice"); if (nullptr == fpCreateDevice) { return VK_ERROR_INITIALIZATION_FAILED; } /* Advance the link info for the next element on the chain. */ layerCreateInfo->u.pLayerInfo = layerCreateInfo->u.pLayerInfo->pNext; /* Copy the extension to a util::extension_list. */ auto &inst_data = instance_private_data::get(physicalDevice); util::allocator allocator{inst_data.get_allocator(), VK_SYSTEM_ALLOCATION_SCOPE_COMMAND, pAllocator}; util::extension_list enabled_extensions{allocator}; VkResult result; result = enabled_extensions.add(pCreateInfo->ppEnabledExtensionNames, pCreateInfo->enabledExtensionCount); if (result != VK_SUCCESS) { return result; } /* Add the extensions required by the platforms that are being enabled in the layer. */ const util::wsi_platform_set& enabled_platforms = inst_data.get_enabled_platforms(); result = wsi::add_extensions_required_by_layer(physicalDevice, enabled_platforms, enabled_extensions); if (result != VK_SUCCESS) { return result; } util::vector modified_enabled_extensions{allocator}; result = enabled_extensions.get_extension_strings(modified_enabled_extensions); if (result != VK_SUCCESS) { return result; } /* Now call create device on the chain further down the list. */ VkDeviceCreateInfo modified_info = *pCreateInfo; modified_info.ppEnabledExtensionNames = modified_enabled_extensions.data(); modified_info.enabledExtensionCount = modified_enabled_extensions.size(); result = fpCreateDevice(physicalDevice, &modified_info, pAllocator, pDevice); if (result != VK_SUCCESS) { return result; } device_dispatch_table table{}; result = table.populate(*pDevice, fpGetDeviceProcAddr); if (result != VK_SUCCESS) { if (table.DestroyDevice != nullptr) { table.DestroyDevice(*pDevice, pAllocator); } return result; } /* Following the spec: use the callbacks provided to vkCreateDevice() if not nullptr, otherwise use the callbacks * provided to the instance (if no allocator callbacks was provided to the instance, it will use default ones). */ util::allocator device_allocator{ inst_data.get_allocator(), VK_SYSTEM_ALLOCATION_SCOPE_DEVICE, pAllocator }; result = device_private_data::associate(*pDevice, inst_data, physicalDevice, table, loader_callback, device_allocator); if (result != VK_SUCCESS) { if (table.DestroyDevice != nullptr) { table.DestroyDevice(*pDevice, pAllocator); } } return result; } } /* namespace layer */ extern "C" { VK_LAYER_EXPORT PFN_vkVoidFunction VKAPI_CALL wsi_layer_vkGetDeviceProcAddr(VkDevice device, const char *funcName); VK_LAYER_EXPORT VKAPI_ATTR PFN_vkVoidFunction VKAPI_CALL wsi_layer_vkGetInstanceProcAddr(VkInstance instance, const char *funcName); /* Clean up the dispatch table for this instance. */ VK_LAYER_EXPORT VKAPI_ATTR void VKAPI_CALL wsi_layer_vkDestroyInstance(VkInstance instance, const VkAllocationCallbacks *pAllocator) { if (instance == VK_NULL_HANDLE) { return; } auto fn_destroy_instance = layer::instance_private_data::get(instance).disp.DestroyInstance; /* Call disassociate() before doing vkDestroyInstance as an instance may be created by a different thread * just after we call vkDestroyInstance() and it could get the same address if we are unlucky. */ layer::instance_private_data::disassociate(instance); assert(fn_destroy_instance); fn_destroy_instance(instance, pAllocator); } VK_LAYER_EXPORT VKAPI_ATTR void VKAPI_CALL wsi_layer_vkDestroyDevice(VkDevice device, const VkAllocationCallbacks *pAllocator) { if (device == VK_NULL_HANDLE) { return; } auto fn_destroy_device = layer::device_private_data::get(device).disp.DestroyDevice; /* Call disassociate() before doing vkDestroyDevice as a device may be created by a different thread * just after we call vkDestroyDevice(). */ layer::device_private_data::disassociate(device); assert(fn_destroy_device); fn_destroy_device(device, pAllocator); } VK_LAYER_EXPORT VKAPI_ATTR VkResult VKAPI_CALL wsi_layer_vkCreateInstance(const VkInstanceCreateInfo *pCreateInfo, const VkAllocationCallbacks *pAllocator, VkInstance *pInstance) { return layer::create_instance(pCreateInfo, pAllocator, pInstance); } VK_LAYER_EXPORT VKAPI_ATTR VkResult VKAPI_CALL wsi_layer_vkCreateDevice(VkPhysicalDevice physicalDevice, const VkDeviceCreateInfo *pCreateInfo, const VkAllocationCallbacks *pAllocator, VkDevice *pDevice) { return layer::create_device(physicalDevice, pCreateInfo, pAllocator, pDevice); } VK_LAYER_EXPORT VKAPI_ATTR VkResult VKAPI_CALL vkNegotiateLoaderLayerInterfaceVersion(VkNegotiateLayerInterface *pVersionStruct) { assert(pVersionStruct); assert(pVersionStruct->sType == LAYER_NEGOTIATE_INTERFACE_STRUCT); /* 2 is the minimum interface version which would utilize this function. */ assert(pVersionStruct->loaderLayerInterfaceVersion >= 2); /* Set our requested interface version. Set to 2 for now to separate us from newer versions. */ pVersionStruct->loaderLayerInterfaceVersion = 2; /* Fill in struct values. */ pVersionStruct->pfnGetInstanceProcAddr = &wsi_layer_vkGetInstanceProcAddr; pVersionStruct->pfnGetDeviceProcAddr = &wsi_layer_vkGetDeviceProcAddr; pVersionStruct->pfnGetPhysicalDeviceProcAddr = nullptr; return VK_SUCCESS; } VK_LAYER_EXPORT VKAPI_ATTR VkResult VKAPI_CALL wsi_layer_vkEnumerateDeviceExtensionProperties( VkPhysicalDevice physicalDevice, const char *pLayerName, uint32_t *pCount, VkExtensionProperties *pProperties) { if (pLayerName && !strcmp(pLayerName, layer::global_layer.layerName)) return layer::extension_properties(1, layer::device_extension, pCount, pProperties); assert(physicalDevice); return layer::instance_private_data::get(physicalDevice) .disp.EnumerateDeviceExtensionProperties(physicalDevice, pLayerName, pCount, pProperties); } VK_LAYER_EXPORT VKAPI_ATTR VkResult VKAPI_CALL wsi_layer_vkEnumerateInstanceExtensionProperties( const VkEnumerateInstanceExtensionPropertiesChain *chain, const char *pLayerName, uint32_t *pCount, VkExtensionProperties *pProperties) { if (pLayerName && !strcmp(pLayerName, layer::global_layer.layerName)) return layer::extension_properties(1, layer::instance_extension, pCount, pProperties); assert(chain); return chain->CallDown(pLayerName, pCount, pProperties); } VK_LAYER_EXPORT VKAPI_ATTR VkResult VKAPI_CALL wsi_layer_vkEnumerateInstanceLayerProperties(uint32_t *pCount, VkLayerProperties *pProperties) { return layer::layer_properties(1, &layer::global_layer, pCount, pProperties); } #define GET_PROC_ADDR(func) \ if (!strcmp(funcName, #func)) \ return (PFN_vkVoidFunction)&wsi_layer_##func; VK_LAYER_EXPORT PFN_vkVoidFunction VKAPI_CALL wsi_layer_vkGetDeviceProcAddr(VkDevice device, const char *funcName) { GET_PROC_ADDR(vkCreateSwapchainKHR); GET_PROC_ADDR(vkDestroySwapchainKHR); GET_PROC_ADDR(vkGetSwapchainImagesKHR); GET_PROC_ADDR(vkAcquireNextImageKHR); GET_PROC_ADDR(vkQueuePresentKHR); GET_PROC_ADDR(vkGetDeviceGroupSurfacePresentModesKHR); GET_PROC_ADDR(vkGetDeviceGroupPresentCapabilitiesKHR); GET_PROC_ADDR(vkAcquireNextImage2KHR); return layer::device_private_data::get(device).disp.GetDeviceProcAddr(device, funcName); } VK_LAYER_EXPORT VKAPI_ATTR PFN_vkVoidFunction VKAPI_CALL wsi_layer_vkGetInstanceProcAddr(VkInstance instance, const char *funcName) { PFN_vkVoidFunction wsi_func = wsi::get_proc_addr(funcName); if (wsi_func) { return wsi_func; } GET_PROC_ADDR(vkGetDeviceProcAddr); GET_PROC_ADDR(vkGetInstanceProcAddr); GET_PROC_ADDR(vkCreateInstance); GET_PROC_ADDR(vkDestroyInstance); GET_PROC_ADDR(vkCreateDevice); GET_PROC_ADDR(vkDestroyDevice); GET_PROC_ADDR(vkGetPhysicalDeviceSurfaceSupportKHR); GET_PROC_ADDR(vkGetPhysicalDeviceSurfaceCapabilitiesKHR); GET_PROC_ADDR(vkGetPhysicalDeviceSurfaceFormatsKHR); GET_PROC_ADDR(vkGetPhysicalDeviceSurfacePresentModesKHR); GET_PROC_ADDR(vkEnumerateDeviceExtensionProperties); GET_PROC_ADDR(vkEnumerateInstanceLayerProperties); GET_PROC_ADDR(vkGetPhysicalDevicePresentRectanglesKHR); return layer::instance_private_data::get(instance).disp.GetInstanceProcAddr(instance, funcName); } } /* extern "C" */