Structure specifying parameters of a newly created video session.

Valid Usage

• If the protectedMemory feature is not enabled or if VkVideoCapabilitiesKHR::flags does not include VIDEO_CAPABILITY_PROTECTED_CONTENT_BIT_KHR, as returned by GetPhysicalDeviceVideoCapabilitiesKHR for the video profile specified by pVideoProfile, then flags must not include VIDEO_SESSION_CREATE_PROTECTED_CONTENT_BIT_KHR
• pVideoProfile must be a supported video profile
• maxDpbSlots must be less than or equal to VkVideoCapabilitiesKHR::maxDpbSlots, as returned by GetPhysicalDeviceVideoCapabilitiesKHR for the video profile specified by pVideoProfile
• maxActiveReferencePictures must be less than or equal to VkVideoCapabilitiesKHR::maxActiveReferencePictures, as returned by GetPhysicalDeviceVideoCapabilitiesKHR for the video profile specified by pVideoProfile
• If either maxDpbSlots or maxActiveReferencePictures is 0, then both must be 0
• maxCodedExtent must be between VkVideoCapabilitiesKHR::minCodedExtent and VkVideoCapabilitiesKHR::maxCodedExtent, inclusive, as returned by GetPhysicalDeviceVideoCapabilitiesKHR for the video profile specified by pVideoProfile
• If pVideoProfile→videoCodecOperation specifies a decode operation and maxActiveReferencePictures is greater than 0, then referencePictureFormat must be one of the supported decode DPB formats, as returned by GetPhysicalDeviceVideoFormatPropertiesKHR in VkVideoFormatPropertiesKHR::format when called with the imageUsage member of its pVideoFormatInfo parameter containing IMAGE_USAGE_VIDEO_DECODE_DPB_BIT_KHR, and with a VkVideoProfileListInfoKHR structure specified in the pNext chain of its pVideoFormatInfo parameter whose pProfiles member contains an element matching pVideoProfile
• If pVideoProfile→videoCodecOperation specifies an encode operation and maxActiveReferencePictures is greater than 0, then referencePictureFormat must be one of the supported decode DPB formats, as returned by then referencePictureFormat must be one of the supported encode DPB formats, as returned by GetPhysicalDeviceVideoFormatPropertiesKHR in VkVideoFormatPropertiesKHR::format when called with the imageUsage member of its pVideoFormatInfo parameter containing IMAGE_USAGE_VIDEO_ENCODE_DPB_BIT_KHR, and with a VkVideoProfileListInfoKHR structure specified in the pNext chain of its pVideoFormatInfo parameter whose pProfiles member contains an element matching pVideoProfile
• If pVideoProfile→videoCodecOperation specifies a decode operation, then pictureFormat must be one of the supported decode output formats, as returned by GetPhysicalDeviceVideoFormatPropertiesKHR in VkVideoFormatPropertiesKHR::format when called with the imageUsage member of its pVideoFormatInfo parameter containing IMAGE_USAGE_VIDEO_DECODE_DST_BIT_KHR, and with a VkVideoProfileListInfoKHR structure specified in the pNext chain of its pVideoFormatInfo parameter whose pProfiles member contains an element matching pVideoProfile
• If pVideoProfile→videoCodecOperation specifies an encode operation, then pictureFormat must be one of the supported encode input formats, as returned by GetPhysicalDeviceVideoFormatPropertiesKHR in VkVideoFormatPropertiesKHR::format when called with the imageUsage member of its pVideoFormatInfo parameter containing IMAGE_USAGE_VIDEO_ENCODE_SRC_BIT_KHR, and with a VkVideoProfileListInfoKHR structure specified in the pNext chain of its pVideoFormatInfo parameter whose pProfiles member contains an element matching pVideoProfile
• pStdHeaderVersion→extensionName must match VkVideoCapabilitiesKHR::stdHeaderVersion.extensionName, as returned by GetPhysicalDeviceVideoCapabilitiesKHR for the video profile specified by pVideoProfile
• pStdHeaderVersion→specVersion must be less than or equal to VkVideoCapabilitiesKHR::stdHeaderVersion.specVersion, as returned by GetPhysicalDeviceVideoCapabilitiesKHR for the video profile specified by pVideoProfile

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_VIDEO_SESSION_CREATE_INFO_KHR
• Each pNext member of any structure (including this one) in the pNext chain must be either NULL or a pointer to a valid instance of VkVideoEncodeH264SessionCreateInfoEXT or VkVideoEncodeH265SessionCreateInfoEXT
• The sType value of each struct in the pNext chain must be unique
• flags must be a valid combination of VkVideoSessionCreateFlagBitsKHR values
• pVideoProfile must be a valid pointer to a valid VkVideoProfileInfoKHR structure
• pictureFormat must be a valid VkFormat value
• referencePictureFormat must be a valid VkFormat value
• pStdHeaderVersion must be a valid pointer to a valid VkExtensionProperties structure

See Also

VkExtensionProperties, VkExtent2D, VkVideoProfileInfoKHR, CreateVideoSessionKHR

Layout

struct VkVideoSessionCreateInfoKHR {
    VkStructureType sType;
    void const * pNext;
    uint32_t queueFamilyIndex;
    VkVideoSessionCreateFlagsKHR flags;
    VkVideoProfileInfoKHR const * pVideoProfile;
    VkFormat pictureFormat;
    VkExtent2D maxCodedExtent;
    VkFormat referencePictureFormat;
    uint32_t maxDpbSlots;
    uint32_t maxActiveReferencePictures;
    VkExtensionProperties const * pStdHeaderVersion;
}