A chained structure containing the parameters to create a D3D12 resource backed by a Vulkan image. More...

#include <vkd3d.h>

Data Fields
enum vkd3d_structure_type	type
	Must be set to VKD3D_STRUCTURE_TYPE_IMAGE_RESOURCE_CREATE_INFO. More...

const void *	next
	Optional pointer to a structure containing further parameters. More...

VkImage	vk_image
	The Vulkan image that backs the resource. More...

D3D12_RESOURCE_DESC	desc
	The resource description. More...

unsigned int	flags
	A combination of zero or more flags. More...

D3D12_RESOURCE_STATES	present_state
	This field specifies how to handle resource state D3D12_RESOURCE_STATE_PRESENT for the resource. More...

Detailed Description

A chained structure containing the parameters to create a D3D12 resource backed by a Vulkan image.

Field Documentation

◆ desc

D3D12_RESOURCE_DESC vkd3d_image_resource_create_info::desc

The resource description.

◆ flags

unsigned int vkd3d_image_resource_create_info::flags

A combination of zero or more flags.

The valid flags are VKD3D_RESOURCE_INITIAL_STATE_TRANSITION and VKD3D_RESOURCE_PRESENT_STATE_TRANSITION.

◆ next

const void* vkd3d_image_resource_create_info::next

Optional pointer to a structure containing further parameters.

◆ present_state

D3D12_RESOURCE_STATES vkd3d_image_resource_create_info::present_state

This field specifies how to handle resource state D3D12_RESOURCE_STATE_PRESENT for the resource.

Notice that on D3D12 there is no difference between D3D12_RESOURCE_STATE_COMMON and D3D12_RESOURCE_STATE_PRESENT (they have the same value), while on Vulkan two different layouts are used (VK_IMAGE_LAYOUT_GENERAL and VK_IMAGE_LAYOUT_PRESENT_SRC_KHR).

When flag VKD3D_RESOURCE_PRESENT_STATE_TRANSITION is not specified, field present_state is ignored and resource state D3D12_RESOURCE_STATE_COMMON/_PRESENT is mapped to VK_IMAGE_LAYOUT_GENERAL; this is useful for non-swapchain resources.
Otherwise, when present_state is D3D12_RESOURCE_STATE_PRESENT/_COMMON, resource state D3D12_RESOURCE_STATE_COMMON/_PRESENT is mapped to VK_IMAGE_LAYOUT_PRESENT_SRC_KHR; this is useful for swapchain resources that are directly backed by a Vulkan swapchain image.
Otherwise, resource state D3D12_RESOURCE_STATE_COMMON/_PRESENT is treated as resource state present_state; this is useful for swapchain resources that backed by a Vulkan non-swapchain image, which the client will likely consume with a copy or drawing operation at presentation time.

◆ type

enum vkd3d_structure_type vkd3d_image_resource_create_info::type

Must be set to VKD3D_STRUCTURE_TYPE_IMAGE_RESOURCE_CREATE_INFO.

◆ vk_image

VkImage vkd3d_image_resource_create_info::vk_image

The Vulkan image that backs the resource.

The documentation for this struct was generated from the following file:

include/vkd3d.h

Data Fields