Add Vulkan profiles

This commit is contained in:
2026-05-25 22:51:00 +01:00
parent aef45cf034
commit dd9d8fe791
4 changed files with 9805 additions and 0 deletions
File diff suppressed because it is too large Load Diff
+433
View File
@@ -0,0 +1,433 @@
/*
* Copyright (C) 2021-2026 Valve Corporation
* Copyright (C) 2021-2026 LunarG, Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License")
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* This file is ***GENERATED***. Do Not Edit.
* See scripts/gen_profiles_solution.py for modifications.
*/
#ifndef VULKAN_PROFILES_H_
#define VULKAN_PROFILES_H_ 1
#define VPAPI_ATTR
#ifdef __cplusplus
extern "C" {
#endif
#include <volk/volk.h>
#if defined(VK_VERSION_1_3) && \
defined(VK_KHR_get_surface_capabilities2) && \
defined(VK_KHR_global_priority) && \
defined(VK_KHR_swapchain)
#define VP_LEARN_how_to_vulkan_2026 1
#define VP_LEARN_HOW_TO_VULKAN_2026_NAME "VP_LEARN_how_to_vulkan_2026"
#define VP_LEARN_HOW_TO_VULKAN_2026_SPEC_VERSION 1
#define VP_LEARN_HOW_TO_VULKAN_2026_MIN_API_VERSION VK_MAKE_VERSION(1, 3, 204)
#endif
#define VP_HEADER_VERSION_COMPLETE VK_MAKE_API_VERSION(0, 2, 0, VK_HEADER_VERSION)
#define VP_MAX_PROFILE_NAME_SIZE 256U
typedef struct VpProfileProperties {
char profileName[VP_MAX_PROFILE_NAME_SIZE];
uint32_t specVersion;
} VpProfileProperties;
typedef struct VpBlockProperties {
VpProfileProperties profiles;
uint32_t apiVersion;
char blockName[VP_MAX_PROFILE_NAME_SIZE];
} VpBlockProperties;
typedef struct VpVideoProfileProperties {
char name[VP_MAX_PROFILE_NAME_SIZE];
} VpVideoProfileProperties;
typedef enum VpInstanceCreateFlagBits {
VP_INSTANCE_CREATE_FLAG_BITS_MAX_ENUM = 0x7FFFFFFF
} VpInstanceCreateFlagBits;
typedef VkFlags VpInstanceCreateFlags;
typedef struct VpInstanceCreateInfo {
const VkInstanceCreateInfo* pCreateInfo;
VpInstanceCreateFlags flags;
uint32_t enabledFullProfileCount;
const VpProfileProperties* pEnabledFullProfiles;
uint32_t enabledProfileBlockCount;
const VpBlockProperties* pEnabledProfileBlocks;
} VpInstanceCreateInfo;
typedef enum VpDeviceCreateFlagBits {
VP_DEVICE_CREATE_DISABLE_ROBUST_BUFFER_ACCESS_BIT = 0x0000001,
VP_DEVICE_CREATE_DISABLE_ROBUST_IMAGE_ACCESS_BIT = 0x0000002,
VP_DEVICE_CREATE_DISABLE_ROBUST_ACCESS =
VP_DEVICE_CREATE_DISABLE_ROBUST_BUFFER_ACCESS_BIT | VP_DEVICE_CREATE_DISABLE_ROBUST_IMAGE_ACCESS_BIT,
VP_DEVICE_CREATE_FLAG_BITS_MAX_ENUM = 0x7FFFFFFF
} VpDeviceCreateFlagBits;
typedef VkFlags VpDeviceCreateFlags;
typedef struct VpDeviceCreateInfo {
const VkDeviceCreateInfo* pCreateInfo;
VpDeviceCreateFlags flags;
uint32_t enabledFullProfileCount;
const VpProfileProperties* pEnabledFullProfiles;
uint32_t enabledProfileBlockCount;
const VpBlockProperties* pEnabledProfileBlocks;
} VpDeviceCreateInfo;
VK_DEFINE_HANDLE(VpCapabilities)
typedef enum VpCapabilitiesCreateFlagBits {
VP_PROFILE_CREATE_STATIC_BIT = (1 << 0),
//VP_PROFILE_CREATE_DYNAMIC_BIT = (1 << 1),
VP_PROFILE_CREATE_FLAG_BITS_MAX_ENUM = 0x7FFFFFFF
} VpCapabilitiesCreateFlagBits;
typedef VkFlags VpCapabilitiesCreateFlags;
// Pointers to some Vulkan functions - a subset used by the library.
// Used in VpCapabilitiesCreateInfo::pVulkanFunctions.
typedef struct VpVulkanFunctions {
/// Required when using VP_DYNAMIC_VULKAN_FUNCTIONS.
PFN_vkGetInstanceProcAddr GetInstanceProcAddr;
/// Required when using VP_DYNAMIC_VULKAN_FUNCTIONS.
PFN_vkGetDeviceProcAddr GetDeviceProcAddr;
PFN_vkEnumerateInstanceVersion EnumerateInstanceVersion;
PFN_vkEnumerateInstanceExtensionProperties EnumerateInstanceExtensionProperties;
PFN_vkEnumerateDeviceExtensionProperties EnumerateDeviceExtensionProperties;
PFN_vkGetPhysicalDeviceFeatures2 GetPhysicalDeviceFeatures2;
PFN_vkGetPhysicalDeviceProperties2 GetPhysicalDeviceProperties2;
PFN_vkGetPhysicalDeviceFormatProperties2 GetPhysicalDeviceFormatProperties2;
PFN_vkGetPhysicalDeviceQueueFamilyProperties2 GetPhysicalDeviceQueueFamilyProperties2;
PFN_vkCreateInstance CreateInstance;
PFN_vkCreateDevice CreateDevice;
} VpVulkanFunctions;
/// Description of a Allocator to be created.
typedef struct VpCapabilitiesCreateInfo
{
/// Flags for created allocator. Use #VpInstanceCreateFlagBits enum.
VpCapabilitiesCreateFlags flags;
uint32_t apiVersion;
const VpVulkanFunctions* pVulkanFunctions;
} VpCapabilitiesCreateInfo;
VPAPI_ATTR VkResult vpCreateCapabilities(
const VpCapabilitiesCreateInfo* pCreateInfo,
const VkAllocationCallbacks* pAllocator,
VpCapabilities* pCapabilities);
/// Destroys allocator object.
VPAPI_ATTR void vpDestroyCapabilities(
VpCapabilities capabilities,
const VkAllocationCallbacks* pAllocator);
// Query the list of available profiles in the library
VPAPI_ATTR VkResult vpGetProfiles(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
uint32_t* pPropertyCount,
VpProfileProperties* pProperties);
// List the required profiles of a profile
VPAPI_ATTR VkResult vpGetProfileRequiredProfiles(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const VpProfileProperties* pProfile,
uint32_t* pPropertyCount,
VpProfileProperties* pProperties);
// Query the profile required Vulkan API version
VPAPI_ATTR uint32_t vpGetProfileAPIVersion(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const VpProfileProperties* pProfile);
// List the recommended fallback profiles of a profile
VPAPI_ATTR VkResult vpGetProfileFallbacks(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const VpProfileProperties* pProfile,
uint32_t* pPropertyCount,
VpProfileProperties* pProperties);
// Query whether the profile has multiple variants. Profiles with multiple variants can only use vpGetInstanceProfileSupport and vpGetPhysicalDeviceProfileSupport capabilities of the library. Other function will return a VK_ERROR_UNKNOWN error
VPAPI_ATTR VkResult vpHasMultipleVariantsProfile(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const VpProfileProperties* pProfile,
VkBool32* pHasMultipleVariants);
// Check whether a profile is supported at the instance level
VPAPI_ATTR VkResult vpGetInstanceProfileSupport(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const char* pLayerName,
const VpProfileProperties* pProfile,
VkBool32* pSupported);
// Check whether a variant of a profile is supported at the instance level and report this list of blocks used to validate the profiles
VPAPI_ATTR VkResult vpGetInstanceProfileVariantsSupport(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const char* pLayerName,
const VpProfileProperties* pProfile,
VkBool32* pSupported,
uint32_t* pPropertyCount,
VpBlockProperties* pProperties);
// Create a VkInstance with the profile instance extensions enabled
VPAPI_ATTR VkResult vpCreateInstance(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const VpInstanceCreateInfo* pCreateInfo,
const VkAllocationCallbacks* pAllocator,
VkInstance* pInstance);
// Check whether a profile is supported by the physical device
VPAPI_ATTR VkResult vpGetPhysicalDeviceProfileSupport(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
VkInstance instance,
VkPhysicalDevice physicalDevice,
const VpProfileProperties* pProfile,
VkBool32* pSupported);
// Check whether a variant of a profile is supported by the physical device and report this list of blocks used to validate the profiles
VPAPI_ATTR VkResult vpGetPhysicalDeviceProfileVariantsSupport(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
VkInstance instance,
VkPhysicalDevice physicalDevice,
const VpProfileProperties* pProfile,
VkBool32* pSupported,
uint32_t* pPropertyCount,
VpBlockProperties* pProperties);
// Create a VkDevice with the profile features and device extensions enabled
VPAPI_ATTR VkResult vpCreateDevice(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
VkPhysicalDevice physicalDevice,
const VpDeviceCreateInfo* pCreateInfo,
const VkAllocationCallbacks* pAllocator,
VkDevice* pDevice);
// Query the list of instance extensions of a profile
VPAPI_ATTR VkResult vpGetProfileInstanceExtensionProperties(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const VpProfileProperties* pProfile,
const char* pBlockName,
uint32_t* pPropertyCount,
VkExtensionProperties* pProperties);
// Query the list of device extensions of a profile
VPAPI_ATTR VkResult vpGetProfileDeviceExtensionProperties(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const VpProfileProperties* pProfile,
const char* pBlockName,
uint32_t* pPropertyCount,
VkExtensionProperties* pProperties);
// Fill the feature structures with the requirements of a profile
VPAPI_ATTR VkResult vpGetProfileFeatures(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const VpProfileProperties* pProfile,
const char* pBlockName,
void* pNext);
// Query the list of feature structure types specified by the profile
VPAPI_ATTR VkResult vpGetProfileFeatureStructureTypes(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const VpProfileProperties* pProfile,
const char* pBlockName,
uint32_t* pStructureTypeCount,
VkStructureType* pStructureTypes);
// Fill the property structures with the requirements of a profile
VPAPI_ATTR VkResult vpGetProfileProperties(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const VpProfileProperties* pProfile,
const char* pBlockName,
void* pNext);
// Query the list of property structure types specified by the profile
VPAPI_ATTR VkResult vpGetProfilePropertyStructureTypes(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const VpProfileProperties* pProfile,
const char* pBlockName,
uint32_t* pStructureTypeCount,
VkStructureType* pStructureTypes);
// Fill the queue family property structures with the requirements of a profile
VPAPI_ATTR VkResult vpGetProfileQueueFamilyProperties(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const VpProfileProperties* pProfile,
const char* pBlockName,
uint32_t* pPropertyCount,
VkQueueFamilyProperties2KHR* pProperties);
// Query the list of queue family property structure types specified by the profile
VPAPI_ATTR VkResult vpGetProfileQueueFamilyStructureTypes(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const VpProfileProperties* pProfile,
const char* pBlockName,
uint32_t* pStructureTypeCount,
VkStructureType* pStructureTypes);
// Query the list of formats with specified requirements by a profile
VPAPI_ATTR VkResult vpGetProfileFormats(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const VpProfileProperties* pProfile,
const char* pBlockName,
uint32_t* pFormatCount,
VkFormat* pFormats);
// Query the requirements of a format for a profile
VPAPI_ATTR VkResult vpGetProfileFormatProperties(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const VpProfileProperties* pProfile,
const char* pBlockName,
VkFormat format,
void* pNext);
// Query the list of format structure types specified by the profile
VPAPI_ATTR VkResult vpGetProfileFormatStructureTypes(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const VpProfileProperties* pProfile,
const char* pBlockName,
uint32_t* pStructureTypeCount,
VkStructureType* pStructureTypes);
#ifdef VK_KHR_video_queue
// Query the list of video profiles specified by the profile
VPAPI_ATTR VkResult vpGetProfileVideoProfiles(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const VpProfileProperties* pProfile,
const char* pBlockName,
uint32_t* pVideoProfileCount,
VpVideoProfileProperties* pVideoProfiles);
// Query the video profile info structures for a video profile defined by a profile
VPAPI_ATTR VkResult vpGetProfileVideoProfileInfo(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const VpProfileProperties* pProfile,
const char* pBlockName,
uint32_t videoProfileIndex,
VkVideoProfileInfoKHR* pVideoProfileInfo);
// Query the list of video profile info structure types specified by the profile for a video profile
VPAPI_ATTR VkResult vpGetProfileVideoProfileInfoStructureTypes(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const VpProfileProperties* pProfile,
const char* pBlockName,
uint32_t videoProfileIndex,
uint32_t* pStructureTypeCount,
VkStructureType* pStructureTypes);
// Query the video capabilities requirements for a video profile defined by a profile
VPAPI_ATTR VkResult vpGetProfileVideoCapabilities(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const VpProfileProperties* pProfile,
const char* pBlockName,
uint32_t videoProfileIndex,
void* pNext);
// Query the list of video capability structure types specified by the profile for a video profile
VPAPI_ATTR VkResult vpGetProfileVideoCapabilityStructureTypes(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const VpProfileProperties* pProfile,
const char* pBlockName,
uint32_t videoProfileIndex,
uint32_t* pStructureTypeCount,
VkStructureType* pStructureTypes);
// Query the video format property requirements for a video profile defined by a profile
VPAPI_ATTR VkResult vpGetProfileVideoFormatProperties(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const VpProfileProperties* pProfile,
const char* pBlockName,
uint32_t videoProfileIndex,
uint32_t* pPropertyCount,
VkVideoFormatPropertiesKHR* pProperties);
// Query the list of video format property structure types specified by the profile for a video profile
VPAPI_ATTR VkResult vpGetProfileVideoFormatStructureTypes(
#ifdef VP_USE_OBJECT
VpCapabilities capabilities,
#endif//VP_USE_OBJECT
const VpProfileProperties* pProfile,
const char* pBlockName,
uint32_t videoProfileIndex,
uint32_t* pStructureTypeCount,
VkStructureType* pStructureTypes);
#endif // VK_KHR_video_queue
#ifdef __cplusplus
}
#endif
#endif // VULKAN_PROFILES_H_
File diff suppressed because it is too large Load Diff