Structures

VkVideoCapabilitiesKHR

Structure describing general video capabilities for a video profile

The VkVideoCapabilitiesKHR structure is defined as:

typedef struct VkVideoCapabilitiesKHR {
    VkStructureType sType;
    void* pNext;
    VkVideoCapabilityFlagsKHR flags;
    VkDeviceSize minBitstreamBufferOffsetAlignment;
    VkDeviceSize minBitstreamBufferSizeAlignment;
    VkExtent2D pictureAccessGranularity;
    VkExtent2D minCodedExtent;
    VkExtent2D maxCodedExtent;
    uint32_t maxDpbSlots;
    uint32_t maxActiveReferencePictures;
    VkExtensionProperties stdHeaderVersion;
} VkVideoCapabilitiesKHR;
  • sType is a VkStructureType value identifying this structure.
  • pNext is NULL or a pointer to a structure extending this structure.
  • flags is a bitmask of VkVideoCapabilityFlagBitsKHR specifying capability flags.
  • minBitstreamBufferOffsetAlignment is the minimum alignment for bitstream buffer offsets.
  • minBitstreamBufferSizeAlignment is the minimum alignment for bitstream buffer range sizes.
  • pictureAccessGranularity is the granularity at which image access to video picture resources happen.
  • minCodedExtent is the minimum width and height of the coded frames.
  • maxCodedExtent is the maximum width and height of the coded frames.
  • maxDpbSlots is the maximum number of DPB slots supported by a single video session.
  • maxActiveReferencePictures is the maximum number of active reference pictures a single video coding operation can use.
  • stdHeaderVersion is a VkExtensionProperties structure reporting the Video Std header name and version supported for the video profile.

It is common for video compression standards to allow using all reference pictures associated with active DPB slots as active reference pictures, hence for video decode profiles the values returned in maxDpbSlots and maxActiveReferencePictures are often equal. Similarly, in case of video decode profiles supporting field pictures the value of maxActiveReferencePictures often equals maxDpbSlots × 2.

Valid Usage (Implicit)

VUID-VkVideoCapabilitiesKHR-sType-sType

sType must be VK_STRUCTURE_TYPE_VIDEO_CAPABILITIES_KHR

VUID-VkVideoCapabilitiesKHR-sType-unique

The sType value of each struct in the pNext chain must be unique