Function Prototype

vkGetPhysicalDeviceVideoCapabilitiesKHR

Query video coding capabilities

To query video coding capabilities for a specific video profile, call:

VkResult vkGetPhysicalDeviceVideoCapabilitiesKHR(
    VkPhysicalDevice physicalDevice,
    const VkVideoProfileInfoKHR* pVideoProfile,
    VkVideoCapabilitiesKHR* pCapabilities);
  • physicalDevice is the physical device from which to query the video decode or encode capabilities.
  • pVideoProfile is a pointer to a VkVideoProfileInfoKHR structure.
  • pCapabilities is a pointer to a VkVideoCapabilitiesKHR structure in which the capabilities are returned.

If the video profile described by pVideoProfile is supported by the implementation, then this command returns VK_SUCCESS and pCapabilities is filled with the capabilities supported with the specified video profile. Otherwise, one of the video-profile-specific error codes are returned.

Valid Usage

VUID-vkGetPhysicalDeviceVideoCapabilitiesKHR-pVideoProfile-07183

If pVideoProfile→videoCodecOperation specifies a decode operation, then the pNext chain of pCapabilities must include a VkVideoDecodeCapabilitiesKHR structure

VUID-vkGetPhysicalDeviceVideoCapabilitiesKHR-pVideoProfile-07184

If pVideoProfile→videoCodecOperation is VK_VIDEO_CODEC_OPERATION_DECODE_H264_BIT_KHR, then the pNext chain of pCapabilities must include a VkVideoDecodeH264CapabilitiesKHR structure

VUID-vkGetPhysicalDeviceVideoCapabilitiesKHR-pVideoProfile-07185

If pVideoProfile→videoCodecOperation is VK_VIDEO_CODEC_OPERATION_DECODE_H265_BIT_KHR, then the pNext chain of pCapabilities must include a VkVideoDecodeH265CapabilitiesKHR structure

VUID-vkGetPhysicalDeviceVideoCapabilitiesKHR-pVideoProfile-09257

If pVideoProfile→videoCodecOperation is VK_VIDEO_CODEC_OPERATION_DECODE_AV1_BIT_KHR, then the pNext chain of pCapabilities must include a VkVideoDecodeAV1CapabilitiesKHR structure

VUID-vkGetPhysicalDeviceVideoCapabilitiesKHR-pVideoProfile-07186

If pVideoProfile→videoCodecOperation specifies an encode operation, then the pNext chain of pCapabilities must include a VkVideoEncodeCapabilitiesKHR structure

VUID-vkGetPhysicalDeviceVideoCapabilitiesKHR-pVideoProfile-07187

If pVideoProfile→videoCodecOperation is VK_VIDEO_CODEC_OPERATION_ENCODE_H264_BIT_KHR, then the pNext chain of pCapabilities must include a VkVideoEncodeH264CapabilitiesKHR structure

VUID-vkGetPhysicalDeviceVideoCapabilitiesKHR-pVideoProfile-07188

If pVideoProfile→videoCodecOperation is VK_VIDEO_CODEC_OPERATION_ENCODE_H265_BIT_KHR, then the pNext chain of pCapabilities must include a VkVideoEncodeH265CapabilitiesKHR structure