VkVideoDecodeInfoKHR(3)
C Specification
TheVkVideoDecodeInfoKHR structure is defined as:
// Provided by VK_KHR_video_decode_queuetypedef struct VkVideoDecodeInfoKHR { VkStructureType sType; const void* pNext; VkVideoDecodeFlagsKHR flags; VkBuffer srcBuffer; VkDeviceSize srcBufferOffset; VkDeviceSize srcBufferRange; VkVideoPictureResourceInfoKHR dstPictureResource; const VkVideoReferenceSlotInfoKHR* pSetupReferenceSlot; uint32_t referenceSlotCount; const VkVideoReferenceSlotInfoKHR* pReferenceSlots;} VkVideoDecodeInfoKHR;Members
sTypeis aVkStructureType value identifying this structure.pNextisNULLor a pointer to a structure extending thisstructure.flagsis reserved for future use.srcBufferis the source video bitstream buffer to read the encodedbitstream from.srcBufferOffsetis the starting offset in bytes from the start ofsrcBufferto read the encoded bitstream from.srcBufferRangeis the size in bytes of the encoded bitstream todecode fromsrcBuffer, starting fromsrcBufferOffset.dstPictureResourceis the video picture resource to use as thedecode output picture.pSetupReferenceSlotisNULLor a pointer to aVkVideoReferenceSlotInfoKHR structure specifying thereconstructed picture information.referenceSlotCountis the number of elements in thepReferenceSlotsarray.pReferenceSlotsisNULLor a pointer to an array ofVkVideoReferenceSlotInfoKHR structures describing the DPB slotsand correspondingreference picture resources touse in this video decode operation (the set ofactive reference pictures).
Description
VUID-VkVideoDecodeInfoKHR-srcBuffer-07165
srcBuffermust have been created with theVK_BUFFER_USAGE_VIDEO_DECODE_SRC_BIT_KHR usage flag setVUID-VkVideoDecodeInfoKHR-srcBufferOffset-07166
srcBufferOffsetmust be less than the size ofsrcBufferVUID-VkVideoDecodeInfoKHR-srcBufferRange-07167
srcBufferRangemust be less than or equal to the size ofsrcBufferminussrcBufferOffsetVUID-VkVideoDecodeInfoKHR-pSetupReferenceSlot-07168
IfpSetupReferenceSlotis notNULL, then itsslotIndexmembermust not be negativeVUID-VkVideoDecodeInfoKHR-pSetupReferenceSlot-07169
IfpSetupReferenceSlotis notNULL, then itspPictureResourcemust not beNULLVUID-VkVideoDecodeInfoKHR-slotIndex-07171
TheslotIndexmember of each element ofpReferenceSlotsmust not be negativeVUID-VkVideoDecodeInfoKHR-pPictureResource-07172
ThepPictureResourcemember of each element ofpReferenceSlotsmust not beNULL
VUID-VkVideoDecodeInfoKHR-sType-sType
sTypemust beVK_STRUCTURE_TYPE_VIDEO_DECODE_INFO_KHRVUID-VkVideoDecodeInfoKHR-pNext-pNext
EachpNextmember of any structure (including this one) in thepNextchainmust be eitherNULLor a pointer to a valid instance ofVkVideoDecodeAV1InlineSessionParametersInfoKHR,VkVideoDecodeAV1PictureInfoKHR,VkVideoDecodeH264InlineSessionParametersInfoKHR,VkVideoDecodeH264PictureInfoKHR,VkVideoDecodeH265InlineSessionParametersInfoKHR,VkVideoDecodeH265PictureInfoKHR,VkVideoDecodeVP9PictureInfoKHR, orVkVideoInlineQueryInfoKHRVUID-VkVideoDecodeInfoKHR-sType-unique
ThesTypevalue of each structure in thepNextchainmust be uniqueVUID-VkVideoDecodeInfoKHR-srcBuffer-parameter
srcBuffermust be a validVkBuffer handleVUID-VkVideoDecodeInfoKHR-dstPictureResource-parameter
dstPictureResourcemust be a validVkVideoPictureResourceInfoKHR structureVUID-VkVideoDecodeInfoKHR-pSetupReferenceSlot-parameter
IfpSetupReferenceSlotis notNULL,pSetupReferenceSlotmust be a valid pointer to a validVkVideoReferenceSlotInfoKHR structureVUID-VkVideoDecodeInfoKHR-pReferenceSlots-parameter
IfreferenceSlotCountis not0,pReferenceSlotsmust be a valid pointer to an array ofreferenceSlotCountvalidVkVideoReferenceSlotInfoKHR structures
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.