FFmpeg: libavutil/vulkan_loader.h Source File

FFmpeg
Loading...
Searching...
No Matches
vulkan_loader.h
Go to the documentation of this file.
1/*
2 * This file is part of FFmpeg.
3 *
4 * FFmpeg is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2.1 of the License, or (at your option) any later version.
8 *
9 * FFmpeg is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
13 *
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with FFmpeg; if not, write to the Free Software
16 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17 */
18
19#ifndef AVUTIL_VULKAN_LOADER_H
20#define AVUTIL_VULKAN_LOADER_H
21
22#include <stdio.h>
23
24#include "avassert.h"
25#include "vulkan_functions.h"
26
27/* Macro to turn a function name into a loader struct */
28 #define PFN_LOAD_INFO(req_inst, req_dev, ext_flag, name) \
29 { \
30 req_inst, \
31 req_dev, \
32 offsetof(FFVulkanFunctions, name), \
33 ext_flag, \
34 },
35
36 static inline uint64_t ff_vk_extensions_to_mask(const char * const *extensions,
37 int nb_extensions)
38{
39 static const struct ExtensionMap {
40 const char *name;
42 } extension_map[] = {
43 /* Instance extensions */
44 { VK_EXT_DEBUG_UTILS_EXTENSION_NAME, FF_VK_EXT_DEBUG_UTILS },
45
46 /* Device extensions */
47#ifdef VK_KHR_shader_relaxed_extended_instruction
48 { VK_KHR_SHADER_RELAXED_EXTENDED_INSTRUCTION_EXTENSION_NAME, FF_VK_EXT_RELAXED_EXTENDED_INSTR },
49#endif
50 { VK_EXT_EXTERNAL_MEMORY_DMA_BUF_EXTENSION_NAME, FF_VK_EXT_EXTERNAL_DMABUF_MEMORY },
51 { VK_EXT_IMAGE_DRM_FORMAT_MODIFIER_EXTENSION_NAME, FF_VK_EXT_DRM_MODIFIER_FLAGS },
52 { VK_KHR_EXTERNAL_MEMORY_FD_EXTENSION_NAME, FF_VK_EXT_EXTERNAL_FD_MEMORY },
53 { VK_KHR_EXTERNAL_SEMAPHORE_FD_EXTENSION_NAME, FF_VK_EXT_EXTERNAL_FD_SEM },
54 { VK_EXT_EXTERNAL_MEMORY_HOST_EXTENSION_NAME, FF_VK_EXT_EXTERNAL_HOST_MEMORY },
55 { VK_EXT_DEBUG_UTILS_EXTENSION_NAME, FF_VK_EXT_DEBUG_UTILS },
56 { VK_EXT_PHYSICAL_DEVICE_DRM_EXTENSION_NAME, FF_VK_EXT_DEVICE_DRM },
57 { VK_EXT_SHADER_ATOMIC_FLOAT_EXTENSION_NAME, FF_VK_EXT_ATOMIC_FLOAT },
58 { VK_KHR_COOPERATIVE_MATRIX_EXTENSION_NAME, FF_VK_EXT_COOP_MATRIX },
59 { VK_NV_OPTICAL_FLOW_EXTENSION_NAME, FF_VK_EXT_OPTICAL_FLOW },
60 { VK_EXT_SHADER_OBJECT_EXTENSION_NAME, FF_VK_EXT_SHADER_OBJECT },
61 { VK_KHR_SHADER_SUBGROUP_ROTATE_EXTENSION_NAME, FF_VK_EXT_SUBGROUP_ROTATE },
62 { VK_EXT_HOST_IMAGE_COPY_EXTENSION_NAME, FF_VK_EXT_HOST_IMAGE_COPY },
63 { VK_KHR_WORKGROUP_MEMORY_EXPLICIT_LAYOUT_EXTENSION_NAME, FF_VK_EXT_EXPLICIT_MEM_LAYOUT },
64#ifdef VK_EXT_shader_long_vector
65 { VK_EXT_SHADER_LONG_VECTOR_EXTENSION_NAME, FF_VK_EXT_LONG_VECTOR },
66#endif
67#ifdef VK_EXT_shader_replicated_composites
68 { VK_EXT_SHADER_REPLICATED_COMPOSITES_EXTENSION_NAME, FF_VK_EXT_REPLICATED_COMPOSITES },
69#endif
70#ifdef VK_EXT_zero_initialize_device_memory
71 { VK_EXT_ZERO_INITIALIZE_DEVICE_MEMORY_EXTENSION_NAME, FF_VK_EXT_ZERO_INITIALIZE },
72#endif
73 { VK_KHR_VIDEO_MAINTENANCE_1_EXTENSION_NAME, FF_VK_EXT_VIDEO_MAINTENANCE_1 },
74#ifdef VK_KHR_video_maintenance2
75 { VK_KHR_VIDEO_MAINTENANCE_2_EXTENSION_NAME, FF_VK_EXT_VIDEO_MAINTENANCE_2 },
76#endif
77#ifdef _WIN32
78 { VK_KHR_EXTERNAL_MEMORY_WIN32_EXTENSION_NAME, FF_VK_EXT_EXTERNAL_WIN32_MEMORY },
79 { VK_KHR_EXTERNAL_SEMAPHORE_WIN32_EXTENSION_NAME, FF_VK_EXT_EXTERNAL_WIN32_SEM },
80#endif
81 { VK_KHR_VIDEO_QUEUE_EXTENSION_NAME, FF_VK_EXT_VIDEO_QUEUE },
82 { VK_KHR_VIDEO_ENCODE_QUEUE_EXTENSION_NAME, FF_VK_EXT_VIDEO_ENCODE_QUEUE },
83 { VK_KHR_VIDEO_DECODE_QUEUE_EXTENSION_NAME, FF_VK_EXT_VIDEO_DECODE_QUEUE },
84 { VK_KHR_VIDEO_ENCODE_H264_EXTENSION_NAME, FF_VK_EXT_VIDEO_ENCODE_H264 },
85 { VK_KHR_VIDEO_DECODE_H264_EXTENSION_NAME, FF_VK_EXT_VIDEO_DECODE_H264 },
86 { VK_KHR_VIDEO_ENCODE_H265_EXTENSION_NAME, FF_VK_EXT_VIDEO_ENCODE_H265 },
87 { VK_KHR_VIDEO_DECODE_H265_EXTENSION_NAME, FF_VK_EXT_VIDEO_DECODE_H265 },
88#ifdef VK_KHR_video_decode_vp9
89 { VK_KHR_VIDEO_DECODE_VP9_EXTENSION_NAME, FF_VK_EXT_VIDEO_DECODE_VP9 },
90#endif
91 { VK_KHR_VIDEO_DECODE_AV1_EXTENSION_NAME, FF_VK_EXT_VIDEO_DECODE_AV1 },
92 { VK_KHR_PUSH_DESCRIPTOR_EXTENSION_NAME, FF_VK_EXT_PUSH_DESCRIPTOR },
93#ifdef VK_KHR_shader_expect_assume
94 { VK_KHR_SHADER_EXPECT_ASSUME_EXTENSION_NAME, FF_VK_EXT_EXPECT_ASSUME },
95#endif
96#ifdef VK_KHR_shader_maximal_reconvergence
97 { VK_KHR_SHADER_MAXIMAL_RECONVERGENCE_EXTENSION_NAME, FF_VK_EXT_MAXIMAL_RECONVERGENCE },
98#endif
99#ifdef VK_KHR_maintenance9
100 { VK_KHR_MAINTENANCE_9_EXTENSION_NAME, FF_VK_EXT_MAINTENANCE_9 },
101#endif
102#ifdef VK_KHR_unified_image_layouts
103 { VK_KHR_UNIFIED_IMAGE_LAYOUTS_EXTENSION_NAME, FF_VK_EXT_UNIFIED_IMAGE_LAYOUTS },
104#endif
105#ifdef VK_KHR_video_encode_av1
106 { VK_KHR_VIDEO_ENCODE_AV1_EXTENSION_NAME, FF_VK_EXT_VIDEO_ENCODE_AV1 },
107#endif
108#ifdef VK_KHR_internally_synchronized_queues
109 { VK_KHR_INTERNALLY_SYNCHRONIZED_QUEUES_EXTENSION_NAME, FF_VK_EXT_INTERNAL_QUEUE_SYNC },
110#endif
111 };
112
114
115 for (int i = 0; i < nb_extensions; i++) {
116 for (int j = 0; j < FF_ARRAY_ELEMS(extension_map); j++) {
117 if (!strcmp(extensions[i], extension_map[j].name)) {
118 mask |= extension_map[j].flag;
119 continue;
120 }
121 }
122 }
123
124 return mask;
125}
126
127/**
128 * Function loader.
129 * Vulkan function from scratch loading happens in 3 stages - the first one
130 * is before any initialization has happened, and you have neither an instance
131 * structure nor a device structure. At this stage, you can only get the bare
132 * minimals to initialize an instance.
133 * The second stage is when you have an instance. At this stage, you can
134 * initialize a VkDevice, and have an idea of what extensions each device
135 * supports.
136 * Finally, in the third stage, you can proceed and load all core functions,
137 * plus you can be sure that any extensions you've enabled during device
138 * initialization will be available.
139 */
142 uint64_t extensions_mask,
143 int has_inst, int has_dev)
144{
145 AVVulkanDeviceContext *hwctx = ctx->hwctx;
146
147 static const struct FunctionLoadInfo {
148 char req_inst;
149 char req_dev;
150 uint16_t struct_offset;
151 FFVulkanExtensions ext_flag;
152 } vk_load_info[] = {
154#ifdef _WIN32
156#endif
157 };
158 // Concatenate the names to avoid relocations. The resulting string
159 // will end with 0円0円
160#define FUNC_NAME(req_inst, req_dev, ext_flag, name) "vk"#name"0円"
161 const char *name =
163#ifdef _WIN32
165#endif
166 ;
167#undef FUNC_NAME
168
169 for (int i = 0; i < FF_ARRAY_ELEMS(vk_load_info); name += strlen(name) + 1, i++) {
170 const struct FunctionLoadInfo *load = &vk_load_info[i];
171 static const char extensions[][4] = { "", "EXT", "KHR" };
172 PFN_vkVoidFunction fn;
173
174 if (load->req_dev && !has_dev)
175 continue;
176 if (load->req_inst && !has_inst)
177 continue;
178
179 for (int j = 0; j < FF_ARRAY_ELEMS(extensions); j++) {
180 char ext_name[128];
181 av_unused int n;
182
183 n = snprintf(ext_name, sizeof(ext_name), "%s%s", name, extensions[j]);
184 av_assert1(n < sizeof(ext_name));
185
186 if (load->req_dev)
187 fn = vk->GetDeviceProcAddr(hwctx->act_dev, ext_name);
188 else if (load->req_inst)
189 fn = hwctx->get_proc_addr(hwctx->inst, ext_name);
190 else
191 fn = hwctx->get_proc_addr(NULL, ext_name);
192
193 if (fn)
194 break;
195 }
196
197 if (!fn && ((extensions_mask &~ FF_VK_EXT_NO_FLAG) & load->ext_flag)) {
198 av_log(ctx, AV_LOG_ERROR, "Loader error, function \"%s\" indicated "
199 "as supported, but got NULL function pointer!\n", name);
200 return AVERROR_EXTERNAL;
201 }
202
203 *(PFN_vkVoidFunction *)((uint8_t *)vk + load->struct_offset) = fn;
204 }
205 av_assert1(*name == '0円');
206
207 return 0;
208}
209
210#endif /* AVUTIL_VULKAN_LOADER_H */
#define fn(a)
Definition aap_template.c:37
static AVFormatContext * ctx
simple assert() macros that are a bit more flexible than ISO C assert().
#define av_assert1(cond)
assert() equivalent, that does not lie in speed critical code.
Definition avassert.h:58
#define flag(name)
Definition cbs_h264.c:60
i
#define i(width, name, range_min, range_max)
Definition cbs_h264.c:63
#define NULL
Definition coverity.c:32
#define AVERROR_EXTERNAL
Generic error in an external library.
Definition error.h:59
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition log.h:210
#define FUNC_NAME(rw, codec, name)
Definition cbs_av1.c:487
#define av_unused
Definition attributes.h:164
static const uint16_t mask[17]
Definition lzw.c:38
const char * name
Definition qsvenc.c:142
#define FF_ARRAY_ELEMS(a)
#define snprintf
Definition snprintf.h:34
This struct aggregates all the (hardware/vendor-specific) "high-level" state, i.e.
Definition hwcontext.h:63
Main Vulkan context, allocated as AVHWDeviceContext.hwctx.
VkDevice act_dev
Active device.
VkInstance inst
Vulkan instance.
PFN_vkGetInstanceProcAddr get_proc_addr
Pointer to a vkGetInstanceProcAddr loading function.
#define av_log(a,...)
#define FF_VK_EXT_VIDEO_ENCODE_AV1
#define FF_VK_EXT_EXPLICIT_MEM_LAYOUT
#define FF_VK_EXT_VIDEO_DECODE_H265
#define FF_VK_EXT_RELAXED_EXTENDED_INSTR
#define FF_VK_EXT_EXTERNAL_FD_SEM
#define FF_VK_EXT_VIDEO_MAINTENANCE_1
#define FF_VK_EXT_DRM_MODIFIER_FLAGS
#define FF_VK_EXT_SHADER_OBJECT
#define FF_VK_EXT_VIDEO_QUEUE
#define FF_VK_EXT_UNIFIED_IMAGE_LAYOUTS
uint64_t FFVulkanExtensions
#define FF_VK_EXT_COOP_MATRIX
#define FF_VK_EXT_INTERNAL_QUEUE_SYNC
#define FN_LIST(MACRO)
#define FF_VK_EXT_VIDEO_ENCODE_QUEUE
#define FF_VK_EXT_NO_FLAG
#define FF_VK_EXT_VIDEO_DECODE_AV1
#define FF_VK_EXT_OPTICAL_FLOW
#define FF_VK_EXT_EXTERNAL_DMABUF_MEMORY
#define FF_VK_EXT_SUBGROUP_ROTATE
#define FF_VK_EXT_PUSH_DESCRIPTOR
#define FF_VK_EXT_MAXIMAL_RECONVERGENCE
#define FF_VK_EXT_DEVICE_DRM
#define FF_VK_EXT_VIDEO_DECODE_H264
#define FF_VK_EXT_VIDEO_ENCODE_H264
#define FF_VK_EXT_VIDEO_DECODE_QUEUE
#define FF_VK_EXT_LONG_VECTOR
#define FF_VK_EXT_VIDEO_DECODE_VP9
#define FN_LIST_WIN32(MACRO)
#define FF_VK_EXT_EXTERNAL_WIN32_SEM
#define FF_VK_EXT_MAINTENANCE_9
#define FF_VK_EXT_EXPECT_ASSUME
#define FF_VK_EXT_HOST_IMAGE_COPY
#define FF_VK_EXT_EXTERNAL_FD_MEMORY
#define FF_VK_EXT_ZERO_INITIALIZE
#define FF_VK_EXT_REPLICATED_COMPOSITES
#define FF_VK_EXT_DEBUG_UTILS
#define FF_VK_EXT_VIDEO_ENCODE_H265
#define FF_VK_EXT_ATOMIC_FLOAT
#define FF_VK_EXT_EXTERNAL_HOST_MEMORY
#define FF_VK_EXT_EXTERNAL_WIN32_MEMORY
#define FF_VK_EXT_VIDEO_MAINTENANCE_2
static uint64_t ff_vk_extensions_to_mask(const char *const *extensions, int nb_extensions)
Definition vulkan_loader.h:36
static int ff_vk_load_functions(AVHWDeviceContext *ctx, FFVulkanFunctions *vk, uint64_t extensions_mask, int has_inst, int has_dev)
Function loader.
#define PFN_LOAD_INFO(req_inst, req_dev, ext_flag, name)
Definition vulkan_loader.h:28
Generated on Sun Sep 6 2026 19:21:11 for FFmpeg by doxygen 1.13.2

AltStyle によって変換されたページ (->オリジナル) /