Movatterモバイル変換

[0]ホーム
URL:

Vulkan API Reference Pageslatest

VkCopyDescriptorSet(3)

Name

VkCopyDescriptorSet - Structure specifying a copy descriptor set operation

C Specification

TheVkCopyDescriptorSet structure is defined as:

// Provided by VK_VERSION_1_0typedef struct VkCopyDescriptorSet {    VkStructureType    sType;    const void*        pNext;    VkDescriptorSet    srcSet;    uint32_t           srcBinding;    uint32_t           srcArrayElement;    VkDescriptorSet    dstSet;    uint32_t           dstBinding;    uint32_t           dstArrayElement;    uint32_t           descriptorCount;} VkCopyDescriptorSet;

Members

  • sType is aVkStructureType value identifying this structure.

  • pNext isNULL or a pointer to a structure extending thisstructure.

  • srcSet,srcBinding, andsrcArrayElement are the sourceset, binding, and array element, respectively.If the descriptor binding identified bysrcSet andsrcBinding has a descriptor type ofVK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK thensrcArrayElementspecifies the starting byte offset within the binding to copy from.

  • dstSet,dstBinding, anddstArrayElement are thedestination set, binding, and array element, respectively.If the descriptor binding identified bydstSet anddstBinding has a descriptor type ofVK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK thendstArrayElementspecifies the starting byte offset within the binding to copy to.

  • descriptorCount is the number of descriptors to copy from thesource to destination.IfdescriptorCount is greater than the number of remaining arrayelements in the source or destination binding, those affect consecutivebindings in a manner similar toVkWriteDescriptorSet above.If the descriptor binding identified bysrcSet andsrcBinding has a descriptor type ofVK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK thendescriptorCountspecifies the number of bytes to copy and the remaining array elementsin the source or destination binding refer to the remaining number ofbytes in those.

Description

If theVkDescriptorSetLayoutBinding fordstBinding isVK_DESCRIPTOR_TYPE_MUTABLE_EXT andsrcBinding is notVK_DESCRIPTOR_TYPE_MUTABLE_EXT, the new active descriptor type becomesthe descriptor type ofsrcBinding.If bothVkDescriptorSetLayoutBinding forsrcBinding anddstBinding areVK_DESCRIPTOR_TYPE_MUTABLE_EXT, the activedescriptor type in each source descriptor is copied into the correspondingdestination descriptor.The active descriptor typecan be different for each source descriptor.

The intention is that copies to and from mutable descriptors is a simplememcpy.Copies between non-mutable and mutable descriptors are expected to requireone memcpy per descriptor to handle the difference in size, but this usecase with more than onedescriptorCount is considered rare.

Valid Usage
Valid Usage (Implicit)

  • VUID-VkCopyDescriptorSet-sType-sType
    sTypemust beVK_STRUCTURE_TYPE_COPY_DESCRIPTOR_SET

  • VUID-VkCopyDescriptorSet-pNext-pNext
    pNextmust beNULL

  • VUID-VkCopyDescriptorSet-srcSet-parameter
    srcSetmust be a validVkDescriptorSet handle

  • VUID-VkCopyDescriptorSet-dstSet-parameter
    dstSetmust be a validVkDescriptorSet handle

  • VUID-VkCopyDescriptorSet-commonparent
    Both ofdstSet, andsrcSetmust have been created, allocated, or retrieved from the sameVkDevice

See Also

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.

[8]ページ先頭
©2009-2026 Movatter.jp