vkd3d  1.12
The vkd3d 3D Graphics Library
vkd3d.h
Go to the documentation of this file.
1 /*
2  * Copyright 2016 Józef Kucia for CodeWeavers
3  *
4  * This library 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  * This library 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 this library; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
17  */
18 
19 #ifndef __VKD3D_H
20 #define __VKD3D_H
21 
22 #include <vkd3d_types.h>
23 
24 #ifndef VKD3D_NO_WIN32_TYPES
25 # include <vkd3d_windows.h>
26 # include <vkd3d_d3d12.h>
27 #endif /* VKD3D_NO_WIN32_TYPES */
28 
29 #ifndef VKD3D_NO_VULKAN_H
30 # include <vulkan/vulkan.h>
31 #endif /* VKD3D_NO_VULKAN_H */
32 
33 #ifdef __cplusplus
34 extern "C" {
35 #endif /* __cplusplus */
36 
51 {
58 
64 
75 
81 
82  VKD3D_FORCE_32_BIT_ENUM(VKD3D_STRUCTURE_TYPE),
83 };
84 
85 enum vkd3d_api_version
86 {
87  VKD3D_API_VERSION_1_0,
88  VKD3D_API_VERSION_1_1,
89  VKD3D_API_VERSION_1_2,
90  VKD3D_API_VERSION_1_3,
91  VKD3D_API_VERSION_1_4,
92  VKD3D_API_VERSION_1_5,
93  VKD3D_API_VERSION_1_6,
94  VKD3D_API_VERSION_1_7,
95  VKD3D_API_VERSION_1_8,
96  VKD3D_API_VERSION_1_9,
97  VKD3D_API_VERSION_1_10,
98  VKD3D_API_VERSION_1_11,
99  VKD3D_API_VERSION_1_12,
100 
101  VKD3D_FORCE_32_BIT_ENUM(VKD3D_API_VERSION),
102 };
103 
104 typedef HRESULT (*PFN_vkd3d_signal_event)(HANDLE event);
105 
106 typedef void * (*PFN_vkd3d_thread)(void *data);
107 
108 typedef void * (*PFN_vkd3d_create_thread)(PFN_vkd3d_thread thread_main, void *data);
109 typedef HRESULT (*PFN_vkd3d_join_thread)(void *thread);
110 
111 struct vkd3d_instance;
112 
117 {
121  const void *next;
122 
124  PFN_vkd3d_signal_event pfn_signal_event;
130  PFN_vkd3d_create_thread pfn_create_thread;
136  PFN_vkd3d_join_thread pfn_join_thread;
138  size_t wchar_size;
139 
144  PFN_vkGetInstanceProcAddr pfn_vkGetInstanceProcAddr;
145 
150  const char * const *instance_extensions;
153 };
154 
163 {
167  const void *next;
168 
173  const char * const *extensions;
175  uint32_t extension_count;
176 };
177 
186 {
190  const void *next;
191 
197  const char *application_name;
200 
204  const char *engine_name;
209  uint32_t engine_version;
210 
215  enum vkd3d_api_version api_version;
216 };
217 
226 {
230  const void *next;
231 
239 };
240 
245 {
249  const void *next;
250 
253  D3D_FEATURE_LEVEL minimum_feature_level;
254 
259  struct vkd3d_instance *instance;
265 
272  VkPhysicalDevice vk_physical_device;
273 
278  const char * const *device_extensions;
281 
286  IUnknown *parent;
292 };
293 
302 {
306  const void *next;
307 
312  const char * const *extensions;
314  uint32_t extension_count;
315 };
316 
323 #define VKD3D_RESOURCE_INITIAL_STATE_TRANSITION 0x00000001
328 #define VKD3D_RESOURCE_PRESENT_STATE_TRANSITION 0x00000002
329 
335 {
339  const void *next;
340 
342  VkImage vk_image;
344  D3D12_RESOURCE_DESC desc;
349  unsigned int flags;
369  D3D12_RESOURCE_STATES present_state;
370 };
371 
372 #ifdef LIBVKD3D_SOURCE
373 # define VKD3D_API VKD3D_EXPORT
374 #else
375 # define VKD3D_API VKD3D_IMPORT
376 #endif
377 
378 #ifndef VKD3D_NO_PROTOTYPES
379 
380 VKD3D_API HRESULT vkd3d_create_instance(const struct vkd3d_instance_create_info *create_info,
381  struct vkd3d_instance **instance);
382 VKD3D_API ULONG vkd3d_instance_decref(struct vkd3d_instance *instance);
383 VKD3D_API VkInstance vkd3d_instance_get_vk_instance(struct vkd3d_instance *instance);
384 VKD3D_API ULONG vkd3d_instance_incref(struct vkd3d_instance *instance);
385 
386 VKD3D_API HRESULT vkd3d_create_device(const struct vkd3d_device_create_info *create_info,
387  REFIID iid, void **device);
388 VKD3D_API IUnknown *vkd3d_get_device_parent(ID3D12Device *device);
389 VKD3D_API VkDevice vkd3d_get_vk_device(ID3D12Device *device);
390 VKD3D_API VkPhysicalDevice vkd3d_get_vk_physical_device(ID3D12Device *device);
391 VKD3D_API struct vkd3d_instance *vkd3d_instance_from_device(ID3D12Device *device);
392 
393 VKD3D_API uint32_t vkd3d_get_vk_queue_family_index(ID3D12CommandQueue *queue);
394 
418 VKD3D_API VkQueue vkd3d_acquire_vk_queue(ID3D12CommandQueue *queue);
419 
430 VKD3D_API void vkd3d_release_vk_queue(ID3D12CommandQueue *queue);
431 
432 VKD3D_API HRESULT vkd3d_create_image_resource(ID3D12Device *device,
433  const struct vkd3d_image_resource_create_info *create_info, ID3D12Resource **resource);
434 VKD3D_API ULONG vkd3d_resource_decref(ID3D12Resource *resource);
435 VKD3D_API ULONG vkd3d_resource_incref(ID3D12Resource *resource);
436 
437 VKD3D_API HRESULT vkd3d_serialize_root_signature(const D3D12_ROOT_SIGNATURE_DESC *desc,
438  D3D_ROOT_SIGNATURE_VERSION version, ID3DBlob **blob, ID3DBlob **error_blob);
439 VKD3D_API HRESULT vkd3d_create_root_signature_deserializer(const void *data, SIZE_T data_size,
440  REFIID iid, void **deserializer);
441 
442 VKD3D_API VkFormat vkd3d_get_vk_format(DXGI_FORMAT format);
443 
444 /* 1.1 */
445 VKD3D_API DXGI_FORMAT vkd3d_get_dxgi_format(VkFormat format);
446 
447 /* 1.2 */
448 VKD3D_API HRESULT vkd3d_serialize_versioned_root_signature(const D3D12_VERSIONED_ROOT_SIGNATURE_DESC *desc,
449  ID3DBlob **blob, ID3DBlob **error_blob);
450 VKD3D_API HRESULT vkd3d_create_versioned_root_signature_deserializer(const void *data, SIZE_T data_size,
451  REFIID iid, void **deserializer);
452 
465 VKD3D_API void vkd3d_set_log_callback(PFN_vkd3d_log callback);
466 
467 #endif /* VKD3D_NO_PROTOTYPES */
468 
469 /*
470  * Function pointer typedefs for vkd3d functions.
471  */
472 typedef HRESULT (*PFN_vkd3d_create_instance)(const struct vkd3d_instance_create_info *create_info,
473  struct vkd3d_instance **instance);
474 typedef ULONG (*PFN_vkd3d_instance_decref)(struct vkd3d_instance *instance);
475 typedef VkInstance (*PFN_vkd3d_instance_get_vk_instance)(struct vkd3d_instance *instance);
476 typedef ULONG (*PFN_vkd3d_instance_incref)(struct vkd3d_instance *instance);
477 
478 typedef HRESULT (*PFN_vkd3d_create_device)(const struct vkd3d_device_create_info *create_info,
479  REFIID iid, void **device);
480 typedef IUnknown * (*PFN_vkd3d_get_device_parent)(ID3D12Device *device);
481 typedef VkDevice (*PFN_vkd3d_get_vk_device)(ID3D12Device *device);
482 typedef VkPhysicalDevice (*PFN_vkd3d_get_vk_physical_device)(ID3D12Device *device);
483 typedef struct vkd3d_instance * (*PFN_vkd3d_instance_from_device)(ID3D12Device *device);
484 
485 typedef uint32_t (*PFN_vkd3d_get_vk_queue_family_index)(ID3D12CommandQueue *queue);
486 typedef VkQueue (*PFN_vkd3d_acquire_vk_queue)(ID3D12CommandQueue *queue);
487 typedef void (*PFN_vkd3d_release_vk_queue)(ID3D12CommandQueue *queue);
488 
489 typedef HRESULT (*PFN_vkd3d_create_image_resource)(ID3D12Device *device,
490  const struct vkd3d_image_resource_create_info *create_info, ID3D12Resource **resource);
491 typedef ULONG (*PFN_vkd3d_resource_decref)(ID3D12Resource *resource);
492 typedef ULONG (*PFN_vkd3d_resource_incref)(ID3D12Resource *resource);
493 
494 typedef HRESULT (*PFN_vkd3d_serialize_root_signature)(const D3D12_ROOT_SIGNATURE_DESC *desc,
495  D3D_ROOT_SIGNATURE_VERSION version, ID3DBlob **blob, ID3DBlob **error_blob);
496 typedef HRESULT (*PFN_vkd3d_create_root_signature_deserializer)(const void *data, SIZE_T data_size,
497  REFIID iid, void **deserializer);
498 
499 typedef VkFormat (*PFN_vkd3d_get_vk_format)(DXGI_FORMAT format);
500 
501 /* 1.1 */
502 typedef DXGI_FORMAT (*PFN_vkd3d_get_dxgi_format)(VkFormat format);
503 
504 /* 1.2 */
505 typedef HRESULT (*PFN_vkd3d_serialize_versioned_root_signature)(const D3D12_VERSIONED_ROOT_SIGNATURE_DESC *desc,
506  ID3DBlob **blob, ID3DBlob **error_blob);
507 typedef HRESULT (*PFN_vkd3d_create_versioned_root_signature_deserializer)(const void *data, SIZE_T data_size,
508  REFIID iid, void **deserializer);
509 
511 typedef void (*PFN_vkd3d_set_log_callback)(PFN_vkd3d_log callback);
512 
513 #ifdef __cplusplus
514 }
515 #endif /* __cplusplus */
516 
517 #endif /* __VKD3D_H */
A chained structure to specify application information.
Definition: vkd3d.h:186
uint32_t engine_version
The engine version, to be passed to the Vulkan implementation.
Definition: vkd3d.h:209
const void * next
Optional pointer to a structure containing further parameters.
Definition: vkd3d.h:190
enum vkd3d_api_version api_version
The vkd3d API version to use, to guarantee backward compatibility of the shared library.
Definition: vkd3d.h:215
const char * engine_name
The engine name, to be passed to the Vulkan implementation.
Definition: vkd3d.h:204
enum vkd3d_structure_type type
Must be set to VKD3D_STRUCTURE_TYPE_APPLICATION_INFO.
Definition: vkd3d.h:188
const char * application_name
The application's name, to be passed to the Vulkan implementation.
Definition: vkd3d.h:197
uint32_t application_version
The application's version, to be passed to the Vulkan implementation.
Definition: vkd3d.h:199
A chained structure containing device creation parameters.
Definition: vkd3d.h:245
struct vkd3d_instance * instance
The vkd3d instance to use to create a device.
Definition: vkd3d.h:259
LUID adapter_luid
The adapter LUID to be set for the device.
Definition: vkd3d.h:291
const struct vkd3d_instance_create_info * instance_create_info
The parameters used to create an instance, which is then used to create a device.
Definition: vkd3d.h:264
IUnknown * parent
An object to be set as the device parent.
Definition: vkd3d.h:286
uint32_t device_extension_count
The number of elements in the device_extensions array.
Definition: vkd3d.h:280
D3D_FEATURE_LEVEL minimum_feature_level
The minimum feature level to request.
Definition: vkd3d.h:253
const char *const * device_extensions
A list of Vulkan device extensions to request.
Definition: vkd3d.h:278
const void * next
Optional pointer to a structure containing further parameters.
Definition: vkd3d.h:249
enum vkd3d_structure_type type
Must be set to VKD3D_STRUCTURE_TYPE_DEVICE_CREATE_INFO.
Definition: vkd3d.h:247
VkPhysicalDevice vk_physical_device
The Vulkan physical device to use.
Definition: vkd3d.h:272
A chained structure to specify the host time domain.
Definition: vkd3d.h:226
enum vkd3d_structure_type type
Must be set to VKD3D_STRUCTURE_TYPE_HOST_TIME_DOMAIN_INFO.
Definition: vkd3d.h:228
const void * next
Optional pointer to a structure containing further parameters.
Definition: vkd3d.h:230
uint64_t ticks_per_second
The number of clock ticks per second, used for GetClockCalibration().
Definition: vkd3d.h:238
A chained structure containing the parameters to create a D3D12 resource backed by a Vulkan image.
Definition: vkd3d.h:335
const void * next
Optional pointer to a structure containing further parameters.
Definition: vkd3d.h:339
VkImage vk_image
The Vulkan image that backs the resource.
Definition: vkd3d.h:342
D3D12_RESOURCE_STATES present_state
This field specifies how to handle resource state D3D12_RESOURCE_STATE_PRESENT for the resource.
Definition: vkd3d.h:369
unsigned int flags
A combination of zero or more flags.
Definition: vkd3d.h:349
D3D12_RESOURCE_DESC desc
The resource description.
Definition: vkd3d.h:344
enum vkd3d_structure_type type
Must be set to VKD3D_STRUCTURE_TYPE_IMAGE_RESOURCE_CREATE_INFO.
Definition: vkd3d.h:337
A chained structure containing instance creation parameters.
Definition: vkd3d.h:117
size_t wchar_size
The size of type WCHAR.
Definition: vkd3d.h:138
const char *const * instance_extensions
A list of Vulkan instance extensions to request.
Definition: vkd3d.h:150
uint32_t instance_extension_count
The number of elements in the instance_extensions array.
Definition: vkd3d.h:152
PFN_vkd3d_signal_event pfn_signal_event
An pointer to a function to signal events.
Definition: vkd3d.h:124
PFN_vkGetInstanceProcAddr pfn_vkGetInstanceProcAddr
A pointer to the vkGetInstanceProcAddr Vulkan function, which will be used to load all the other Vulk...
Definition: vkd3d.h:144
const void * next
Optional pointer to a structure containing further parameters.
Definition: vkd3d.h:121
enum vkd3d_structure_type type
Must be set to VKD3D_STRUCTURE_TYPE_INSTANCE_CREATE_INFO.
Definition: vkd3d.h:119
PFN_vkd3d_join_thread pfn_join_thread
An optional pointer to a function to join threads.
Definition: vkd3d.h:136
PFN_vkd3d_create_thread pfn_create_thread
An optional pointer to a function to create threads.
Definition: vkd3d.h:130
A chained structure to specify optional device extensions.
Definition: vkd3d.h:302
uint32_t extension_count
The number of elements in the extensions array.
Definition: vkd3d.h:314
const char *const * extensions
A list of optional Vulkan device extensions to request.
Definition: vkd3d.h:312
enum vkd3d_structure_type type
Must be set to VKD3D_STRUCTURE_TYPE_OPTIONAL_DEVICE_EXTENSIONS_INFO.
Definition: vkd3d.h:304
const void * next
Optional pointer to a structure containing further parameters.
Definition: vkd3d.h:306
A chained structure to specify optional instance extensions.
Definition: vkd3d.h:163
uint32_t extension_count
The number of elements in the extensions array.
Definition: vkd3d.h:175
enum vkd3d_structure_type type
Must be set to VKD3D_STRUCTURE_TYPE_OPTIONAL_INSTANCE_EXTENSIONS_INFO.
Definition: vkd3d.h:165
const void * next
Optional pointer to a structure containing further parameters.
Definition: vkd3d.h:167
const char *const * extensions
A list of optional Vulkan instance extensions to request.
Definition: vkd3d.h:173
VKD3D_API VkQueue vkd3d_acquire_vk_queue(ID3D12CommandQueue *queue)
Acquire the Vulkan queue backing a command queue.
VKD3D_API void vkd3d_set_log_callback(PFN_vkd3d_log callback)
Set a callback to be called when vkd3d outputs debug logging.
vkd3d_structure_type
The type of a chained structure.
Definition: vkd3d.h:51
@ VKD3D_STRUCTURE_TYPE_HOST_TIME_DOMAIN_INFO
The structure is a vkd3d_host_time_domain_info structure.
Definition: vkd3d.h:80
@ VKD3D_STRUCTURE_TYPE_OPTIONAL_INSTANCE_EXTENSIONS_INFO
The structure is a vkd3d_optional_instance_extensions_info structure.
Definition: vkd3d.h:63
@ VKD3D_STRUCTURE_TYPE_INSTANCE_CREATE_INFO
The structure is a vkd3d_instance_create_info structure.
Definition: vkd3d.h:53
@ VKD3D_STRUCTURE_TYPE_DEVICE_CREATE_INFO
The structure is a vkd3d_device_create_info structure.
Definition: vkd3d.h:55
@ VKD3D_STRUCTURE_TYPE_OPTIONAL_DEVICE_EXTENSIONS_INFO
The structure is a vkd3d_optional_device_extensions_info structure.
Definition: vkd3d.h:69
@ VKD3D_STRUCTURE_TYPE_IMAGE_RESOURCE_CREATE_INFO
The structure is a vkd3d_image_resource_create_info structure.
Definition: vkd3d.h:57
@ VKD3D_STRUCTURE_TYPE_APPLICATION_INFO
The structure is a vkd3d_application_info structure.
Definition: vkd3d.h:74
VKD3D_API void vkd3d_release_vk_queue(ID3D12CommandQueue *queue)
Release the Vulkan queue backing a command queue.
void(* PFN_vkd3d_set_log_callback)(PFN_vkd3d_log callback)
Type of vkd3d_set_log_callback().
Definition: vkd3d.h:511
This file contains definitions for basic types used by vkd3d libraries.