VkCopyTensorInfoARM(3)

Name

VkCopyTensorInfoARM - Structure specifying an tensor copy operation

C Specification

TheVkCopyTensorInfoARM structure is defined as:

// Provided by VK_ARM_tensorstypedef struct VkCopyTensorInfoARM {    VkStructureType           sType;    const void*               pNext;    VkTensorARM               srcTensor;    VkTensorARM               dstTensor;    uint32_t                  regionCount;    const VkTensorCopyARM*    pRegions;} VkCopyTensorInfoARM;

Members

sType is aVkStructureType value identifying this structure.
pNext is NULL or a pointer to a structure extending thisstructure.
srcTensor is the source tensor.
dstTensor is the destination tensor.
regionCount is the number of regions to copy.
pRegions is a pointer to an array ofVkTensorCopyARMstructures specifying the regions to copy.

Description

Each region inpRegions describes a region to be copied from thesource tensor to a corresponding region of the destination tensor.srcTensor anddstTensorcan be the same tensor or alias thesame memory.

The formats ofsrcTensor anddstTensormust be compatible.Formats are compatible if they share the same class, as shown in theCompatible Formats table.

vkCmdCopyTensorARM allows copying betweensize-compatible internalformats.

Valid Usage

VUID-VkCopyTensorInfoARM-dimensionCount-09684
srcTensor anddstTensormust have been created with equalvalues forVkTensorDescriptionARM::dimensionCount
VUID-VkCopyTensorInfoARM-pDimensions-09685
For each of the elements ofVkTensorDescriptionARM::pDimensions,srcTensor anddstTensormust be the same size
VUID-VkCopyTensorInfoARM-regionCount-09686
regionCount must be equal to 1
VUID-VkCopyTensorInfoARM-pRegions-09687
Each element ofpRegionsmust be aVkTensorCopyARMstructure whosepSrcOffset isNULL or has all its elements equalto0
VUID-VkCopyTensorInfoARM-pRegions-09688
Each element ofpRegionsmust be aVkTensorCopyARMstructure whosepDstOffset isNULL or has all its elements equalto0
VUID-VkCopyTensorInfoARM-pRegions-09689
Each element ofpRegionsmust be aVkTensorCopyARMstructure whosepExtent isNULL or equal to theVkTensorDescriptionARM::pDimensions array specified whensrcTensor anddstTensor were created
VUID-VkCopyTensorInfoARM-pRegions-09954
Each element ofpRegionsmust be aVkTensorCopyARMstructure whosedimensionCount, if it is not equal to 0, is equalto the largest of theVkTensorDescriptionARM::dimensionCountofsrcTensor ordstTensor
VUID-VkCopyTensorInfoARM-srcTensor-09690
Theformat features ofsrcTensormust containVK_FORMAT_FEATURE_2_TRANSFER_SRC_BIT
VUID-VkCopyTensorInfoARM-srcTensor-09691
srcTensormust have been created with theVK_TENSOR_USAGE_TRANSFER_SRC_BIT_ARM usage flag set
VUID-VkCopyTensorInfoARM-dstTensor-09692
Theformat features ofdstTensormust containVK_FORMAT_FEATURE_2_TRANSFER_DST_BIT
VUID-VkCopyTensorInfoARM-dstTensor-09693
dstTensormust have been created with theVK_TENSOR_USAGE_TRANSFER_DST_BIT_ARM usage flag set
VUID-VkCopyTensorInfoARM-srcTensor-09694
IfsrcTensor is non-sparse then itmust be bound completely andcontiguously to a singleVkDeviceMemory object
VUID-VkCopyTensorInfoARM-dstTensor-09695
IfdstTensor is non-sparse then itmust be bound completely andcontiguously to a singleVkDeviceMemory object

Valid Usage (Implicit)

VUID-VkCopyTensorInfoARM-sType-sType
sTypemust beVK_STRUCTURE_TYPE_COPY_TENSOR_INFO_ARM
VUID-VkCopyTensorInfoARM-pNext-pNext
pNextmust beNULL
VUID-VkCopyTensorInfoARM-srcTensor-parameter
srcTensormust be a validVkTensorARM handle
VUID-VkCopyTensorInfoARM-dstTensor-parameter
dstTensormust be a validVkTensorARM handle
VUID-VkCopyTensorInfoARM-pRegions-parameter
pRegionsmust be a valid pointer to an array ofregionCount validVkTensorCopyARM structures
VUID-VkCopyTensorInfoARM-regionCount-arraylength
regionCountmust be greater than0
VUID-VkCopyTensorInfoARM-commonparent
Both ofdstTensor, andsrcTensormust have been created, allocated, or retrieved from the sameVkDevice

Document Notes

For more information, see theVulkan Specification.

This page is extracted from the Vulkan Specification.Fixes and changes should be made to the Specification, not directly.

Movatterモバイル変換