vkd3d.h File Reference

#include <vkd3d_types.h>
#include <windows.h>
#include <d3d12.h>
#include <wine/vulkan.h>

Include dependency graph for vkd3d.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	vkd3d_instance_create_info
struct	vkd3d_optional_instance_extensions_info
struct	vkd3d_application_info
struct	vkd3d_host_time_domain_info
struct	vkd3d_device_create_info
struct	vkd3d_optional_device_extensions_info
struct	vkd3d_image_resource_create_info

Macros
#define	VKD3D_RESOURCE_INITIAL_STATE_TRANSITION   0x00000001
#define	VKD3D_RESOURCE_PRESENT_STATE_TRANSITION   0x00000002
#define	VKD3D_API   VKD3D_IMPORT

Typedefs
typedef HRESULT(*	PFN_vkd3d_signal_event) (HANDLE event)
typedef void *(*	PFN_vkd3d_thread) (void *data)
typedef void *(*	PFN_vkd3d_create_thread) (PFN_vkd3d_thread thread_main, void *data)
typedef HRESULT(*	PFN_vkd3d_join_thread) (void *thread)
typedef HRESULT(*	PFN_vkd3d_create_instance) (const struct vkd3d_instance_create_info *create_info, struct vkd3d_instance **instance)
typedef ULONG(*	PFN_vkd3d_instance_decref) (struct vkd3d_instance *instance)
typedef VkInstance(*	PFN_vkd3d_instance_get_vk_instance) (struct vkd3d_instance *instance)
typedef ULONG(*	PFN_vkd3d_instance_incref) (struct vkd3d_instance *instance)
typedef HRESULT(*	PFN_vkd3d_create_device) (const struct vkd3d_device_create_info *create_info, REFIID iid, void **device)
typedef IUnknown *(*	PFN_vkd3d_get_device_parent) (ID3D12Device *device)
typedef VkDevice(*	PFN_vkd3d_get_vk_device) (ID3D12Device *device)
typedef VkPhysicalDevice(*	PFN_vkd3d_get_vk_physical_device) (ID3D12Device *device)
typedef struct vkd3d_instance *(*	PFN_vkd3d_instance_from_device) (ID3D12Device *device)
typedef uint32_t(*	PFN_vkd3d_get_vk_queue_family_index) (ID3D12CommandQueue *queue)
typedef VkQueue(*	PFN_vkd3d_acquire_vk_queue) (ID3D12CommandQueue *queue)
typedef void(*	PFN_vkd3d_release_vk_queue) (ID3D12CommandQueue *queue)
typedef HRESULT(*	PFN_vkd3d_create_image_resource) (ID3D12Device *device, const struct vkd3d_image_resource_create_info *create_info, ID3D12Resource **resource)
typedef ULONG(*	PFN_vkd3d_resource_decref) (ID3D12Resource *resource)
typedef ULONG(*	PFN_vkd3d_resource_incref) (ID3D12Resource *resource)
typedef HRESULT(*	PFN_vkd3d_serialize_root_signature) (const D3D12_ROOT_SIGNATURE_DESC *desc, D3D_ROOT_SIGNATURE_VERSION version, ID3DBlob **blob, ID3DBlob **error_blob)
typedef HRESULT(*	PFN_vkd3d_create_root_signature_deserializer) (const void *data, SIZE_T data_size, REFIID iid, void **deserializer)
typedef VkFormat(*	PFN_vkd3d_get_vk_format) (DXGI_FORMAT format)
typedef DXGI_FORMAT(*	PFN_vkd3d_get_dxgi_format) (VkFormat format)
typedef HRESULT(*	PFN_vkd3d_serialize_versioned_root_signature) (const D3D12_VERSIONED_ROOT_SIGNATURE_DESC *desc, ID3DBlob **blob, ID3DBlob **error_blob)
typedef HRESULT(*	PFN_vkd3d_create_versioned_root_signature_deserializer) (const void *data, SIZE_T data_size, REFIID iid, void **deserializer)
typedef void(*	PFN_vkd3d_set_log_callback) (PFN_vkd3d_log callback)

Enumerations
enum	vkd3d_structure_type {   VKD3D_STRUCTURE_TYPE_INSTANCE_CREATE_INFO , VKD3D_STRUCTURE_TYPE_DEVICE_CREATE_INFO , VKD3D_STRUCTURE_TYPE_IMAGE_RESOURCE_CREATE_INFO , VKD3D_STRUCTURE_TYPE_OPTIONAL_INSTANCE_EXTENSIONS_INFO ,   VKD3D_STRUCTURE_TYPE_OPTIONAL_DEVICE_EXTENSIONS_INFO , VKD3D_STRUCTURE_TYPE_APPLICATION_INFO , VKD3D_STRUCTURE_TYPE_HOST_TIME_DOMAIN_INFO , VKD3D_FORCE_32_BIT_ENUM =(VKD3D_STRUCTURE_TYPE) }
enum	vkd3d_api_version {   VKD3D_API_VERSION_1_0 , VKD3D_API_VERSION_1_1 , VKD3D_API_VERSION_1_2 , VKD3D_API_VERSION_1_3 ,   VKD3D_API_VERSION_1_4 , VKD3D_API_VERSION_1_5 , VKD3D_API_VERSION_1_6 , VKD3D_API_VERSION_1_7 ,   VKD3D_API_VERSION_1_8 , VKD3D_API_VERSION_1_9 , VKD3D_API_VERSION_1_10 , VKD3D_API_VERSION_1_11 ,   VKD3D_API_VERSION_1_12 , VKD3D_API_VERSION_1_13 , VKD3D_API_VERSION_1_14 , VKD3D_FORCE_32_BIT_ENUM =(VKD3D_STRUCTURE_TYPE) }

Functions
VKD3D_API HRESULT	vkd3d_create_instance (const struct vkd3d_instance_create_info *create_info, struct vkd3d_instance **instance)
VKD3D_API ULONG	vkd3d_instance_decref (struct vkd3d_instance *instance)
VKD3D_API VkInstance	vkd3d_instance_get_vk_instance (struct vkd3d_instance *instance)
VKD3D_API ULONG	vkd3d_instance_incref (struct vkd3d_instance *instance)
VKD3D_API HRESULT	vkd3d_create_device (const struct vkd3d_device_create_info *create_info, REFIID iid, void **device)
VKD3D_API IUnknown *	vkd3d_get_device_parent (ID3D12Device *device)
VKD3D_API VkDevice	vkd3d_get_vk_device (ID3D12Device *device)
VKD3D_API VkPhysicalDevice	vkd3d_get_vk_physical_device (ID3D12Device *device)
VKD3D_API struct vkd3d_instance *	vkd3d_instance_from_device (ID3D12Device *device)
VKD3D_API uint32_t	vkd3d_get_vk_queue_family_index (ID3D12CommandQueue *queue)
VKD3D_API VkQueue	vkd3d_acquire_vk_queue (ID3D12CommandQueue *queue)
VKD3D_API void	vkd3d_release_vk_queue (ID3D12CommandQueue *queue)
VKD3D_API HRESULT	vkd3d_create_image_resource (ID3D12Device *device, const struct vkd3d_image_resource_create_info *create_info, ID3D12Resource **resource)
VKD3D_API ULONG	vkd3d_resource_decref (ID3D12Resource *resource)
VKD3D_API ULONG	vkd3d_resource_incref (ID3D12Resource *resource)
VKD3D_API HRESULT	vkd3d_serialize_root_signature (const D3D12_ROOT_SIGNATURE_DESC *desc, D3D_ROOT_SIGNATURE_VERSION version, ID3DBlob **blob, ID3DBlob **error_blob)
VKD3D_API HRESULT	vkd3d_create_root_signature_deserializer (const void *data, SIZE_T data_size, REFIID iid, void **deserializer)
VKD3D_API VkFormat	vkd3d_get_vk_format (DXGI_FORMAT format)
VKD3D_API DXGI_FORMAT	vkd3d_get_dxgi_format (VkFormat format)
VKD3D_API HRESULT	vkd3d_serialize_versioned_root_signature (const D3D12_VERSIONED_ROOT_SIGNATURE_DESC *desc, ID3DBlob **blob, ID3DBlob **error_blob)
VKD3D_API HRESULT	vkd3d_create_versioned_root_signature_deserializer (const void *data, SIZE_T data_size, REFIID iid, void **deserializer)
VKD3D_API void	vkd3d_set_log_callback (PFN_vkd3d_log callback)

Detailed Description

This file contains definitions for the vkd3d library.

The vkd3d library is a 3D graphics library built on top of Vulkan. It has an API very similar, but not identical, to Direct3D 12.

Since

1.0

Definition in file vkd3d.h.

Macro Definition Documentation

VKD3D_API

#define VKD3D_API   VKD3D_IMPORT

Definition at line 377 of file vkd3d.h.

VKD3D_RESOURCE_INITIAL_STATE_TRANSITION

#define VKD3D_RESOURCE_INITIAL_STATE_TRANSITION   0x00000001

When specified as a flag of vkd3d_image_resource_create_info, it means that vkd3d will do the initial transition operation on the image from VK_IMAGE_LAYOUT_UNDEFINED to its appropriate Vulkan layout (depending on its D3D12 resource state). If this flag is not specified the caller is responsible for transitioning the Vulkan image to the appropriate layout.

Definition at line 325 of file vkd3d.h.

VKD3D_RESOURCE_PRESENT_STATE_TRANSITION

#define VKD3D_RESOURCE_PRESENT_STATE_TRANSITION   0x00000002

When specified as a flag of vkd3d_image_resource_create_info, it means that field present_state is honored.

Definition at line 330 of file vkd3d.h.

Typedef Documentation

PFN_vkd3d_acquire_vk_queue

typedef VkQueue(* PFN_vkd3d_acquire_vk_queue) (ID3D12CommandQueue *queue)

Definition at line 488 of file vkd3d.h.

PFN_vkd3d_create_device

typedef HRESULT(* PFN_vkd3d_create_device) (const struct vkd3d_device_create_info *create_info, REFIID iid, void **device)

Definition at line 480 of file vkd3d.h.

PFN_vkd3d_create_image_resource

typedef HRESULT(* PFN_vkd3d_create_image_resource) (ID3D12Device *device, const struct vkd3d_image_resource_create_info *create_info, ID3D12Resource **resource)

Definition at line 491 of file vkd3d.h.

PFN_vkd3d_create_instance

typedef HRESULT(* PFN_vkd3d_create_instance) (const struct vkd3d_instance_create_info *create_info, struct vkd3d_instance **instance)

Definition at line 474 of file vkd3d.h.

PFN_vkd3d_create_root_signature_deserializer

typedef HRESULT(* PFN_vkd3d_create_root_signature_deserializer) (const void *data, SIZE_T data_size, REFIID iid, void **deserializer)

Definition at line 498 of file vkd3d.h.

PFN_vkd3d_create_thread

typedef void *(* PFN_vkd3d_create_thread) (PFN_vkd3d_thread thread_main, void *data)

Definition at line 110 of file vkd3d.h.

PFN_vkd3d_create_versioned_root_signature_deserializer

typedef HRESULT(* PFN_vkd3d_create_versioned_root_signature_deserializer) (const void *data, SIZE_T data_size, REFIID iid, void **deserializer)

Definition at line 509 of file vkd3d.h.

PFN_vkd3d_get_device_parent

typedef IUnknown *(* PFN_vkd3d_get_device_parent) (ID3D12Device *device)

Definition at line 482 of file vkd3d.h.

PFN_vkd3d_get_dxgi_format

typedef DXGI_FORMAT(* PFN_vkd3d_get_dxgi_format) (VkFormat format)

Definition at line 504 of file vkd3d.h.

PFN_vkd3d_get_vk_device

typedef VkDevice(* PFN_vkd3d_get_vk_device) (ID3D12Device *device)

Definition at line 483 of file vkd3d.h.

PFN_vkd3d_get_vk_format

typedef VkFormat(* PFN_vkd3d_get_vk_format) (DXGI_FORMAT format)

Definition at line 501 of file vkd3d.h.

PFN_vkd3d_get_vk_physical_device

typedef VkPhysicalDevice(* PFN_vkd3d_get_vk_physical_device) (ID3D12Device *device)

Definition at line 484 of file vkd3d.h.

PFN_vkd3d_get_vk_queue_family_index

typedef uint32_t(* PFN_vkd3d_get_vk_queue_family_index) (ID3D12CommandQueue *queue)

Definition at line 487 of file vkd3d.h.

PFN_vkd3d_instance_decref

typedef ULONG(* PFN_vkd3d_instance_decref) (struct vkd3d_instance *instance)

Definition at line 476 of file vkd3d.h.

PFN_vkd3d_instance_from_device

typedef struct vkd3d_instance *(* PFN_vkd3d_instance_from_device) (ID3D12Device *device)

Definition at line 484 of file vkd3d.h.

PFN_vkd3d_instance_get_vk_instance

typedef VkInstance(* PFN_vkd3d_instance_get_vk_instance) (struct vkd3d_instance *instance)

Definition at line 477 of file vkd3d.h.

PFN_vkd3d_instance_incref

typedef ULONG(* PFN_vkd3d_instance_incref) (struct vkd3d_instance *instance)

Definition at line 478 of file vkd3d.h.

PFN_vkd3d_join_thread

typedef HRESULT(* PFN_vkd3d_join_thread) (void *thread)

Definition at line 111 of file vkd3d.h.

PFN_vkd3d_release_vk_queue

typedef void(* PFN_vkd3d_release_vk_queue) (ID3D12CommandQueue *queue)

Definition at line 489 of file vkd3d.h.

PFN_vkd3d_resource_decref

typedef ULONG(* PFN_vkd3d_resource_decref) (ID3D12Resource *resource)

Definition at line 493 of file vkd3d.h.

PFN_vkd3d_resource_incref

typedef ULONG(* PFN_vkd3d_resource_incref) (ID3D12Resource *resource)

Definition at line 494 of file vkd3d.h.

PFN_vkd3d_serialize_root_signature

typedef HRESULT(* PFN_vkd3d_serialize_root_signature) (const D3D12_ROOT_SIGNATURE_DESC *desc, D3D_ROOT_SIGNATURE_VERSION version, ID3DBlob **blob, ID3DBlob **error_blob)

Definition at line 496 of file vkd3d.h.

PFN_vkd3d_serialize_versioned_root_signature

typedef HRESULT(* PFN_vkd3d_serialize_versioned_root_signature) (const D3D12_VERSIONED_ROOT_SIGNATURE_DESC *desc, ID3DBlob **blob, ID3DBlob **error_blob)

Definition at line 507 of file vkd3d.h.

PFN_vkd3d_set_log_callback

typedef void(* PFN_vkd3d_set_log_callback) (PFN_vkd3d_log callback)

Type of vkd3d_set_log_callback().

Since

1.4

Definition at line 513 of file vkd3d.h.

PFN_vkd3d_signal_event

typedef HRESULT(* PFN_vkd3d_signal_event) (HANDLE event)

Definition at line 106 of file vkd3d.h.

PFN_vkd3d_thread

typedef void *(* PFN_vkd3d_thread) (void *data)

Definition at line 108 of file vkd3d.h.

Enumeration Type Documentation

vkd3d_api_version

enum vkd3d_api_version

Enumerator
VKD3D_API_VERSION_1_0
VKD3D_API_VERSION_1_1
VKD3D_API_VERSION_1_2
VKD3D_API_VERSION_1_3
VKD3D_API_VERSION_1_4
VKD3D_API_VERSION_1_5
VKD3D_API_VERSION_1_6
VKD3D_API_VERSION_1_7
VKD3D_API_VERSION_1_8
VKD3D_API_VERSION_1_9
VKD3D_API_VERSION_1_10
VKD3D_API_VERSION_1_11
VKD3D_API_VERSION_1_12
VKD3D_API_VERSION_1_13
VKD3D_API_VERSION_1_14
VKD3D_FORCE_32_BIT_ENUM

Definition at line 85 of file vkd3d.h.

{
    VKD3D_API_VERSION_1_0,
    VKD3D_API_VERSION_1_1,
    VKD3D_API_VERSION_1_2,
    VKD3D_API_VERSION_1_3,
    VKD3D_API_VERSION_1_4,
    VKD3D_API_VERSION_1_5,
    VKD3D_API_VERSION_1_6,
    VKD3D_API_VERSION_1_7,
    VKD3D_API_VERSION_1_8,
    VKD3D_API_VERSION_1_9,
    VKD3D_API_VERSION_1_10,
    VKD3D_API_VERSION_1_11,
    VKD3D_API_VERSION_1_12,
    VKD3D_API_VERSION_1_13,
    VKD3D_API_VERSION_1_14,
 
    VKD3D_FORCE_32_BIT_ENUM(VKD3D_API_VERSION),
};

vkd3d_structure_type

enum vkd3d_structure_type

The type of a chained structure.

Enumerator
VKD3D_STRUCTURE_TYPE_INSTANCE_CREATE_INFO	The structure is a vkd3d_instance_create_info structure.
VKD3D_STRUCTURE_TYPE_DEVICE_CREATE_INFO	The structure is a vkd3d_device_create_info structure.
VKD3D_STRUCTURE_TYPE_IMAGE_RESOURCE_CREATE_INFO	The structure is a vkd3d_image_resource_create_info structure.
VKD3D_STRUCTURE_TYPE_OPTIONAL_INSTANCE_EXTENSIONS_INFO	The structure is a vkd3d_optional_instance_extensions_info structure. Since 1.1
VKD3D_STRUCTURE_TYPE_OPTIONAL_DEVICE_EXTENSIONS_INFO	The structure is a vkd3d_optional_device_extensions_info structure. Since 1.2
VKD3D_STRUCTURE_TYPE_APPLICATION_INFO	The structure is a vkd3d_application_info structure. Since 1.2
VKD3D_STRUCTURE_TYPE_HOST_TIME_DOMAIN_INFO	The structure is a vkd3d_host_time_domain_info structure. Since 1.3
VKD3D_FORCE_32_BIT_ENUM

Definition at line 50 of file vkd3d.h.

{
    VKD3D_STRUCTURE_TYPE_INSTANCE_CREATE_INFO,
    VKD3D_STRUCTURE_TYPE_DEVICE_CREATE_INFO,
    VKD3D_STRUCTURE_TYPE_IMAGE_RESOURCE_CREATE_INFO,
 
    VKD3D_STRUCTURE_TYPE_OPTIONAL_INSTANCE_EXTENSIONS_INFO,
 
    VKD3D_STRUCTURE_TYPE_OPTIONAL_DEVICE_EXTENSIONS_INFO,
    VKD3D_STRUCTURE_TYPE_APPLICATION_INFO,
 
    VKD3D_STRUCTURE_TYPE_HOST_TIME_DOMAIN_INFO,
 
    VKD3D_FORCE_32_BIT_ENUM(VKD3D_STRUCTURE_TYPE),
};

Function Documentation

vkd3d_acquire_vk_queue()

VKD3D_API VkQueue vkd3d_acquire_vk_queue

(

ID3D12CommandQueue *

queue

)

Acquire the Vulkan queue backing a command queue.

While a queue is acquired by the client, it is locked so that neither the vkd3d library nor other threads can submit work to it. For that reason it should be released as soon as possible with vkd3d_release_vk_queue(). The lock is not reentrant, so the same queue must not be acquired more than once by the same thread.

Work submitted through the Direct3D 12 API exposed by vkd3d is not always immediately submitted to the Vulkan queue; sometimes it is kept in another internal queue, which might not necessarily be empty at the time vkd3d_acquire_vk_queue() is called. For this reason, work submitted directly to the Vulkan queue might appear to the Vulkan driver as being submitted before other work submitted though the Direct3D 12 API. If this is not desired, it is recommended to synchronize work submission using an ID3D12Fence object, by submitting to the queue a signal operation after all the Direct3D 12 work is submitted and waiting for it before calling vkd3d_acquire_vk_queue().

Since

1.0

Definition at line 7493 of file command.c.

{
    struct d3d12_command_queue *d3d12_queue = impl_from_ID3D12CommandQueue(queue);
    VkQueue vk_queue = vkd3d_queue_acquire(d3d12_queue->vkd3d_queue);
 
    if (d3d12_queue->op_queue.count)
        WARN("Acquired command queue %p with %zu remaining ops.\n", d3d12_queue, d3d12_queue->op_queue.count);
    else if (d3d12_queue->is_flushing)
        WARN("Acquired command queue %p which is flushing.\n", d3d12_queue);
 
    return vk_queue;
}

Referenced by d3d12_swapchain_destroy_vulkan_resources(), and d3d12_swapchain_queue_present().

vkd3d_create_device()

VKD3D_API HRESULT vkd3d_create_device	(	const struct vkd3d_device_create_info *	create_info,
		REFIID	iid,
		void **	device
	)

Definition at line 23 of file vkd3d_main.c.

{
    struct vkd3d_instance *instance;
    struct d3d12_device *object;
    HRESULT hr;
 
    TRACE("create_info %p, iid %s, device %p.\n", create_info, debugstr_guid(iid), device);
 
    if (!create_info)
        return E_INVALIDARG;
    if (create_info->type != VKD3D_STRUCTURE_TYPE_DEVICE_CREATE_INFO)
    {
        WARN("Invalid structure type %#x.\n", create_info->type);
        return E_INVALIDARG;
    }
    if (!create_info->instance && !create_info->instance_create_info)
    {
        WARN("Instance or instance create info is required.\n");
        return E_INVALIDARG;
    }
    if (create_info->instance && create_info->instance_create_info)
    {
        WARN("Instance and instance create info are mutually exclusive parameters.\n");
        return E_INVALIDARG;
    }
 
    if (create_info->minimum_feature_level < D3D_FEATURE_LEVEL_11_0
            || !is_valid_feature_level(create_info->minimum_feature_level))
    {
        WARN("Invalid feature level %#x.\n", create_info->minimum_feature_level);
        return E_INVALIDARG;
    }
 
    if ((instance = create_info->instance))
    {
        vkd3d_instance_incref(instance);
    }
    else if (FAILED(hr = vkd3d_create_instance(create_info->instance_create_info, &instance)))
    {
        WARN("Failed to create instance, hr %s.\n", debugstr_hresult(hr));
        return E_FAIL;
    }
 
    hr = d3d12_device_create(instance, create_info, &object);
    vkd3d_instance_decref(instance);
    if (FAILED(hr))
        return hr;
 
    if (!device)
    {
        ID3D12Device9_Release(&object->ID3D12Device9_iface);
        return S_FALSE;
    }
 
    return return_interface(&object->ID3D12Device9_iface, &IID_ID3D12Device, iid, device);
}

Referenced by D3D12CreateDevice().

vkd3d_create_image_resource()

VKD3D_API HRESULT vkd3d_create_image_resource	(	ID3D12Device *	device,
		const struct vkd3d_image_resource_create_info *	create_info,
		ID3D12Resource **	resource
	)

Definition at line 2264 of file resource.c.

{
    struct d3d12_device *d3d12_device = unsafe_impl_from_ID3D12Device9((ID3D12Device9 *)device);
    struct d3d12_resource *object;
    HRESULT hr;
 
    TRACE("device %p, create_info %p, resource %p.\n", device, create_info, resource);
 
    if (!create_info || !resource)
        return E_INVALIDARG;
    if (create_info->type != VKD3D_STRUCTURE_TYPE_IMAGE_RESOURCE_CREATE_INFO)
    {
        WARN("Invalid structure type %#x.\n", create_info->type);
        return E_INVALIDARG;
    }
    if (create_info->next)
        WARN("Unhandled next %p.\n", create_info->next);
 
    if (!(object = vkd3d_malloc(sizeof(*object))))
        return E_OUTOFMEMORY;
 
    memset(object, 0, sizeof(*object));
 
    object->ID3D12Resource2_iface.lpVtbl = &d3d12_resource_vtbl;
    object->refcount = 1;
    object->internal_refcount = 1;
    d3d12_resource_desc1_from_desc(&object->desc, &create_info->desc);
    object->format = vkd3d_format_from_d3d12_resource_desc(d3d12_device, &object->desc, 0);
    object->u.vk_image = create_info->vk_image;
    object->flags = VKD3D_RESOURCE_EXTERNAL;
    object->flags |= create_info->flags & VKD3D_RESOURCE_PUBLIC_FLAGS;
    object->initial_state = D3D12_RESOURCE_STATE_COMMON;
    if (create_info->flags & VKD3D_RESOURCE_PRESENT_STATE_TRANSITION)
        object->present_state = create_info->present_state;
    else
        object->present_state = D3D12_RESOURCE_STATE_COMMON;
 
    if (FAILED(hr = vkd3d_private_store_init(&object->private_store)))
    {
        vkd3d_free(object);
        return hr;
    }
 
    d3d12_device_add_ref(object->device = d3d12_device);
 
    TRACE("Created resource %p.\n", object);
 
    *resource = (ID3D12Resource *)&object->ID3D12Resource2_iface;
 
    return S_OK;
}

Referenced by d3d12_swapchain_create_image_resources().

vkd3d_create_instance()

VKD3D_API HRESULT vkd3d_create_instance	(	const struct vkd3d_instance_create_info *	create_info,
		struct vkd3d_instance **	instance
	)

Definition at line 734 of file device.c.

{
    struct vkd3d_instance *object;
    HRESULT hr;
 
    TRACE("create_info %p, instance %p.\n", create_info, instance);
 
    if (!create_info || !instance)
        return E_INVALIDARG;
    if (create_info->type != VKD3D_STRUCTURE_TYPE_INSTANCE_CREATE_INFO)
    {
        WARN("Invalid structure type %#x.\n", create_info->type);
        return E_INVALIDARG;
    }
 
    if (!(object = vkd3d_malloc(sizeof(*object))))
        return E_OUTOFMEMORY;
 
    if (FAILED(hr = vkd3d_instance_init(object, create_info)))
    {
        vkd3d_free(object);
        return hr;
    }
 
    TRACE("Created instance %p.\n", object);
 
    *instance = object;
 
    return S_OK;
}

Referenced by D3D12CreateDevice(), and vkd3d_create_device().

vkd3d_create_root_signature_deserializer()

VKD3D_API HRESULT vkd3d_create_root_signature_deserializer	(	const void *	data,
		SIZE_T	data_size,
		REFIID	iid,
		void **	deserializer
	)

Definition at line 218 of file vkd3d_main.c.

{
    struct vkd3d_shader_code dxbc = {data, data_size};
    struct d3d12_root_signature_deserializer *object;
    HRESULT hr;
 
    TRACE("data %p, data_size %"PRIuPTR", iid %s, deserializer %p.\n",
            data, (uintptr_t)data_size, debugstr_guid(iid), deserializer);
 
    if (!(object = vkd3d_malloc(sizeof(*object))))
        return E_OUTOFMEMORY;
 
    if (FAILED(hr = d3d12_root_signature_deserializer_init(object, &dxbc)))
    {
        vkd3d_free(object);
        return hr;
    }
 
    return return_interface(&object->ID3D12RootSignatureDeserializer_iface,
            &IID_ID3D12RootSignatureDeserializer, iid, deserializer);
}

Referenced by D3D12CreateRootSignatureDeserializer().

vkd3d_create_versioned_root_signature_deserializer()

VKD3D_API HRESULT vkd3d_create_versioned_root_signature_deserializer	(	const void *	data,
		SIZE_T	data_size,
		REFIID	iid,
		void **	deserializer
	)

Definition at line 402 of file vkd3d_main.c.

{
    struct d3d12_versioned_root_signature_deserializer *object;
    struct vkd3d_shader_code dxbc = {data, data_size};
    HRESULT hr;
 
    TRACE("data %p, data_size %"PRIuPTR", iid %s, deserializer %p.\n",
            data, (uintptr_t)data_size, debugstr_guid(iid), deserializer);
 
    if (!(object = vkd3d_malloc(sizeof(*object))))
        return E_OUTOFMEMORY;
 
    if (FAILED(hr = d3d12_versioned_root_signature_deserializer_init(object, &dxbc)))
    {
        vkd3d_free(object);
        *deserializer = NULL;
        return hr;
    }
 
    return return_interface(&object->ID3D12VersionedRootSignatureDeserializer_iface,
            &IID_ID3D12VersionedRootSignatureDeserializer, iid, deserializer);
}

Referenced by D3D12CreateVersionedRootSignatureDeserializer().

vkd3d_get_device_parent()

VKD3D_API IUnknown * vkd3d_get_device_parent

(

ID3D12Device *

device

)

Definition at line 5694 of file device.c.

{
    struct d3d12_device *d3d12_device = impl_from_ID3D12Device9((ID3D12Device9 *)device);
 
    return d3d12_device->parent;
}

Referenced by d3d12_swapchain_GetContainingOutput().

vkd3d_get_dxgi_format()

VKD3D_API DXGI_FORMAT vkd3d_get_dxgi_format

(

VkFormat

format

)

Definition at line 530 of file utils.c.

{
    DXGI_FORMAT dxgi_format;
    VkFormat vk_format;
    unsigned int i;
 
    for (i = 0; i < ARRAY_SIZE(vkd3d_formats); ++i)
    {
        vk_format = vkd3d_formats[i].vk_format;
        dxgi_format = vkd3d_formats[i].dxgi_format;
        if (vk_format == format && vkd3d_formats[i].type != VKD3D_FORMAT_TYPE_TYPELESS)
            return dxgi_format;
    }
 
    FIXME("Unhandled Vulkan format %#x.\n", format);
    return DXGI_FORMAT_UNKNOWN;
}

vkd3d_get_vk_device()

VKD3D_API VkDevice vkd3d_get_vk_device

(

ID3D12Device *

device

)

Definition at line 5701 of file device.c.

{
    struct d3d12_device *d3d12_device = impl_from_ID3D12Device9((ID3D12Device9 *)device);
 
    return d3d12_device->vk_device;
}

Referenced by d3d12_swapchain_init().

vkd3d_get_vk_format()

VKD3D_API VkFormat vkd3d_get_vk_format

(

DXGI_FORMAT

format

)

Definition at line 520 of file utils.c.

{
    const struct vkd3d_format *vkd3d_format;
 
    if (!(vkd3d_format = vkd3d_get_format(NULL, format, false)))
        return VK_FORMAT_UNDEFINED;
 
    return vkd3d_format->vk_format;
}

Referenced by d3d12_swapchain_create_d3d12_resources(), select_vk_format(), and vkd3d_init_format_compatibility_lists().

vkd3d_get_vk_physical_device()

VKD3D_API VkPhysicalDevice vkd3d_get_vk_physical_device

(

ID3D12Device *

device

)

Definition at line 5708 of file device.c.

{
    struct d3d12_device *d3d12_device = impl_from_ID3D12Device9((ID3D12Device9 *)device);
 
    return d3d12_device->vk_physical_device;
}

Referenced by d3d12_swapchain_init().

vkd3d_get_vk_queue_family_index()

VKD3D_API uint32_t vkd3d_get_vk_queue_family_index

(

ID3D12CommandQueue *

queue

)

Definition at line 7486 of file command.c.

{
    struct d3d12_command_queue *d3d12_queue = impl_from_ID3D12CommandQueue(queue);
 
    return d3d12_queue->vkd3d_queue->vk_family_index;
}

Referenced by d3d12_swapchain_create_command_buffers(), and d3d12_swapchain_init().

vkd3d_instance_decref()

VKD3D_API ULONG vkd3d_instance_decref

(

struct vkd3d_instance *

instance

)

Definition at line 791 of file device.c.

{
    unsigned int refcount = vkd3d_atomic_decrement_u32(&instance->refcount);
 
    TRACE("%p decreasing refcount to %u.\n", instance, refcount);
 
    if (!refcount)
        vkd3d_destroy_instance(instance);
 
    return refcount;
}

Referenced by d3d12_device_init(), d3d12_device_Release(), D3D12CreateDevice(), and vkd3d_create_device().

vkd3d_instance_from_device()

VKD3D_API struct vkd3d_instance * vkd3d_instance_from_device

(

ID3D12Device *

device

)

Definition at line 5715 of file device.c.

{
    struct d3d12_device *d3d12_device = impl_from_ID3D12Device9((ID3D12Device9 *)device);
 
    return d3d12_device->vkd3d_instance;
}

Referenced by d3d12_swapchain_init().

vkd3d_instance_get_vk_instance()

VKD3D_API VkInstance vkd3d_instance_get_vk_instance

(

struct vkd3d_instance *

instance

)

Definition at line 803 of file device.c.

{
    return instance->vk_instance;
}

Referenced by d3d12_get_vk_physical_device(), and d3d12_swapchain_init().

vkd3d_instance_incref()

VKD3D_API ULONG vkd3d_instance_incref

(

struct vkd3d_instance *

instance

)

Definition at line 782 of file device.c.

{
    unsigned int refcount = vkd3d_atomic_increment_u32(&instance->refcount);
 
    TRACE("%p increasing refcount to %u.\n", instance, refcount);
 
    return refcount;
}

Referenced by d3d12_device_init(), and vkd3d_create_device().

vkd3d_release_vk_queue()

VKD3D_API void vkd3d_release_vk_queue

(

ID3D12CommandQueue *

queue

)

Release the Vulkan queue backing a command queue.

This must be paired to an earlier corresponding vkd3d_acquire_vk_queue(). After this function is called, the Vulkan queue returned by vkd3d_acquire_vk_queue() must not be used any more.

Since

1.0

Definition at line 7506 of file command.c.

{
    struct d3d12_command_queue *d3d12_queue = impl_from_ID3D12CommandQueue(queue);
 
    return vkd3d_queue_release(d3d12_queue->vkd3d_queue);
}

Referenced by d3d12_swapchain_destroy_vulkan_resources(), and d3d12_swapchain_queue_present().

vkd3d_resource_decref()

VKD3D_API ULONG vkd3d_resource_decref

(

ID3D12Resource *

resource

)

Definition at line 2323 of file resource.c.

{
    TRACE("resource %p.\n", resource);
    return d3d12_resource_decref(impl_from_ID3D12Resource(resource));
}

Referenced by d3d12_swapchain_destroy_d3d12_resources().

vkd3d_resource_incref()

VKD3D_API ULONG vkd3d_resource_incref

(

ID3D12Resource *

resource

)

Definition at line 2317 of file resource.c.

{
    TRACE("resource %p.\n", resource);
    return d3d12_resource_incref(impl_from_ID3D12Resource(resource));
}

Referenced by d3d12_swapchain_create_image_resources().

vkd3d_serialize_root_signature()

VKD3D_API HRESULT vkd3d_serialize_root_signature	(	const D3D12_ROOT_SIGNATURE_DESC *	desc,
		D3D_ROOT_SIGNATURE_VERSION	version,
		ID3DBlob **	blob,
		ID3DBlob **	error_blob
	)

Definition at line 426 of file vkd3d_main.c.

{
    struct vkd3d_shader_versioned_root_signature_desc vkd3d_desc;
    struct vkd3d_shader_code dxbc;
    char *messages;
    HRESULT hr;
    int ret;
 
    TRACE("desc %p, version %#x, blob %p, error_blob %p.\n", desc, version, blob, error_blob);
 
    if (version != D3D_ROOT_SIGNATURE_VERSION_1_0)
    {
        WARN("Unexpected Root signature version %#x.\n", version);
        return E_INVALIDARG;
    }
 
    if (!blob)
    {
        WARN("Invalid blob parameter.\n");
        return E_INVALIDARG;
    }
 
    if (error_blob)
        *error_blob = NULL;
 
    vkd3d_desc.version = VKD3D_SHADER_ROOT_SIGNATURE_VERSION_1_0;
    vkd3d_desc.u.v_1_0 = *(const struct vkd3d_shader_root_signature_desc *)desc;
    if ((ret = vkd3d_shader_serialize_root_signature(&vkd3d_desc, &dxbc, &messages)) < 0)
    {
        WARN("Failed to serialize root signature, vkd3d result %d.\n", ret);
        if (!error_blob)
            vkd3d_shader_free_messages(messages);
        else if (messages && FAILED(hr = vkd3d_blob_create(messages, strlen(messages), error_blob)))
            ERR("Failed to create error blob, hr %s.\n", debugstr_hresult(hr));
        return hresult_from_vkd3d_result(ret);
    }
    vkd3d_shader_free_messages(messages);
 
    if (FAILED(hr = vkd3d_blob_create((void *)dxbc.code, dxbc.size, blob)))
    {
        WARN("Failed to create blob object, hr %s.\n", debugstr_hresult(hr));
        vkd3d_shader_free_shader_code(&dxbc);
    }
    return hr;
}

Referenced by D3D12SerializeRootSignature().

vkd3d_serialize_versioned_root_signature()

VKD3D_API HRESULT vkd3d_serialize_versioned_root_signature	(	const D3D12_VERSIONED_ROOT_SIGNATURE_DESC *	desc,
		ID3DBlob **	blob,
		ID3DBlob **	error_blob
	)

Definition at line 473 of file vkd3d_main.c.

{
    const struct vkd3d_shader_versioned_root_signature_desc *vkd3d_desc;
    struct vkd3d_shader_code dxbc;
    char *messages;
    HRESULT hr;
    int ret;
 
    TRACE("desc %p, blob %p, error_blob %p.\n", desc, blob, error_blob);
 
    if (!blob)
    {
        WARN("Invalid blob parameter.\n");
        return E_INVALIDARG;
    }
 
    if (error_blob)
        *error_blob = NULL;
 
    vkd3d_desc = (const struct vkd3d_shader_versioned_root_signature_desc *)desc;
    if ((ret = vkd3d_shader_serialize_root_signature(vkd3d_desc, &dxbc, &messages)) < 0)
    {
        WARN("Failed to serialize root signature, vkd3d result %d.\n", ret);
        if (!error_blob)
            vkd3d_shader_free_messages(messages);
        else if (messages && FAILED(hr = vkd3d_blob_create(messages, strlen(messages), error_blob)))
            ERR("Failed to create error blob, hr %s.\n", debugstr_hresult(hr));
        return hresult_from_vkd3d_result(ret);
    }
    vkd3d_shader_free_messages(messages);
 
    if (FAILED(hr = vkd3d_blob_create((void *)dxbc.code, dxbc.size, blob)))
    {
        WARN("Failed to create blob object, hr %s.\n", debugstr_hresult(hr));
        vkd3d_shader_free_shader_code(&dxbc);
    }
    return hr;
}

Referenced by D3D12SerializeVersionedRootSignature().

vkd3d_set_log_callback()

VKD3D_API void vkd3d_set_log_callback

(

PFN_vkd3d_log

callback

)

Set a callback to be called when vkd3d outputs debug logging.

If NULL, or if this function has not been called, libvkd3d will print all enabled log output to stderr.

Calling this function will also set the log callback for libvkd3d-shader.

Parameters

callback

Callback function to set.

Since

1.4

Definition at line 513 of file vkd3d_main.c.

{
    vkd3d_shader_set_log_callback(callback);
    vkd3d_dbg_set_log_callback(callback);
}

Referenced by wined3d_dll_init().