Package org.lwjgl.vulkan

Class KHRVideoDecodeQueue

java.lang.Object

org.lwjgl.vulkan.KHRVideoDecodeQueue

public class KHRVideoDecodeQueue
extends Object

This extension builds upon the VK_KHR_video_queue extension by adding common APIs specific to video decoding and thus enabling implementations to expose queue families supporting video decode operations.

More specifically, it adds video decode specific capabilities and a new command buffer command that allows recording video decode operations against a video session.

This extension is to be used in conjunction with other codec specific video decode extensions that enable decoding video sequences of specific video compression standards.

Name String

VK_KHR_video_decode_queue

Extension Type

Device extension

Registered Extension Number

25

Revision

8

Extension and Version Dependencies

VK_KHR_video_queue and VK_KHR_synchronization2 or Version 1.3

API Interactions

• Interacts with VK_VERSION_1_3
• Interacts with VK_KHR_format_feature_flags2

Contact

• jake.beju@amd.com

Extension Proposal

VK_KHR_video_decode_queue

Other Extension Metadata

Last Modified Date

2023-12-05

IP Status

No known IP claims.

Contributors

• Ahmed Abdelkhalek, AMD
• Jake Beju, AMD
• Olivier Lapicque, NVIDIA
• Peter Fang, AMD
• Piers Daniell, NVIDIA
• Srinath Kumarapuram, NVIDIA
• Tony Zlatinski, NVIDIA
• Daniel Rakos, RasterGrid

Field Summary

Fields

Modifier and Type	Field	Description
static final long	VK_ACCESS_2_VIDEO_DECODE_READ_BIT_KHR	Extends VkAccessFlagBits2.
static final long	VK_ACCESS_2_VIDEO_DECODE_WRITE_BIT_KHR	Extends VkAccessFlagBits2.
static final int	VK_BUFFER_USAGE_VIDEO_DECODE_DST_BIT_KHR	Extends VkBufferUsageFlagBits.
static final int	VK_BUFFER_USAGE_VIDEO_DECODE_SRC_BIT_KHR	Extends VkBufferUsageFlagBits.
static final long	VK_FORMAT_FEATURE_2_VIDEO_DECODE_DPB_BIT_KHR	Extends VkFormatFeatureFlagBits2.
static final long	VK_FORMAT_FEATURE_2_VIDEO_DECODE_OUTPUT_BIT_KHR	Extends VkFormatFeatureFlagBits2.
static final int	VK_FORMAT_FEATURE_VIDEO_DECODE_DPB_BIT_KHR	Extends VkFormatFeatureFlagBits.
static final int	VK_FORMAT_FEATURE_VIDEO_DECODE_OUTPUT_BIT_KHR	Extends VkFormatFeatureFlagBits.
static final int	VK_IMAGE_LAYOUT_VIDEO_DECODE_DPB_KHR	Extends VkImageLayout.
static final int	VK_IMAGE_LAYOUT_VIDEO_DECODE_DST_KHR	Extends VkImageLayout.
static final int	VK_IMAGE_LAYOUT_VIDEO_DECODE_SRC_KHR	Extends VkImageLayout.
static final int	VK_IMAGE_USAGE_VIDEO_DECODE_DPB_BIT_KHR	Extends VkImageUsageFlagBits.
static final int	VK_IMAGE_USAGE_VIDEO_DECODE_DST_BIT_KHR	Extends VkImageUsageFlagBits.
static final int	VK_IMAGE_USAGE_VIDEO_DECODE_SRC_BIT_KHR	Extends VkImageUsageFlagBits.
static final String	VK_KHR_VIDEO_DECODE_QUEUE_EXTENSION_NAME	The extension name.
static final int	VK_KHR_VIDEO_DECODE_QUEUE_SPEC_VERSION	The extension specification version.
static final long	VK_PIPELINE_STAGE_2_VIDEO_DECODE_BIT_KHR	Extends VkPipelineStageFlagBits2.
static final int	VK_QUEUE_VIDEO_DECODE_BIT_KHR	Extends VkQueueFlagBits.
static final int	VK_STRUCTURE_TYPE_VIDEO_DECODE_CAPABILITIES_KHR	Extends VkStructureType.
static final int	VK_STRUCTURE_TYPE_VIDEO_DECODE_INFO_KHR	Extends VkStructureType.
static final int	VK_STRUCTURE_TYPE_VIDEO_DECODE_USAGE_INFO_KHR	Extends VkStructureType.
static final int	VK_VIDEO_DECODE_CAPABILITY_DPB_AND_OUTPUT_COINCIDE_BIT_KHR	VkVideoDecodeCapabilityFlagBitsKHR - Video decode capability flags
static final int	VK_VIDEO_DECODE_CAPABILITY_DPB_AND_OUTPUT_DISTINCT_BIT_KHR	VkVideoDecodeCapabilityFlagBitsKHR - Video decode capability flags
static final int	VK_VIDEO_DECODE_USAGE_DEFAULT_KHR	VkVideoDecodeUsageFlagBitsKHR - Video decode usage flags
static final int	VK_VIDEO_DECODE_USAGE_OFFLINE_BIT_KHR	VkVideoDecodeUsageFlagBitsKHR - Video decode usage flags
static final int	VK_VIDEO_DECODE_USAGE_STREAMING_BIT_KHR	VkVideoDecodeUsageFlagBitsKHR - Video decode usage flags
static final int	VK_VIDEO_DECODE_USAGE_TRANSCODING_BIT_KHR	VkVideoDecodeUsageFlagBitsKHR - Video decode usage flags

Method Summary

Modifier and Type	Method	Description
static void	nvkCmdDecodeVideoKHR(org.lwjgl.vulkan.VkCommandBuffer commandBuffer, long pDecodeInfo)	Unsafe version of: CmdDecodeVideoKHR
static void	vkCmdDecodeVideoKHR(org.lwjgl.vulkan.VkCommandBuffer commandBuffer, VkVideoDecodeInfoKHR pDecodeInfo)	Launch a video decode operation.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

VK_KHR_VIDEO_DECODE_QUEUE_SPEC_VERSION

public static final int VK_KHR_VIDEO_DECODE_QUEUE_SPEC_VERSION

The extension specification version.

See Also:

• Constant Field Values

VK_KHR_VIDEO_DECODE_QUEUE_EXTENSION_NAME

public static final String VK_KHR_VIDEO_DECODE_QUEUE_EXTENSION_NAME

The extension name.

See Also:

• Constant Field Values

VK_STRUCTURE_TYPE_VIDEO_DECODE_INFO_KHR

public static final int VK_STRUCTURE_TYPE_VIDEO_DECODE_INFO_KHR

Extends VkStructureType.

Enum values:

• STRUCTURE_TYPE_VIDEO_DECODE_INFO_KHR
• STRUCTURE_TYPE_VIDEO_DECODE_CAPABILITIES_KHR
• STRUCTURE_TYPE_VIDEO_DECODE_USAGE_INFO_KHR

See Also:

• Constant Field Values

VK_STRUCTURE_TYPE_VIDEO_DECODE_CAPABILITIES_KHR

public static final int VK_STRUCTURE_TYPE_VIDEO_DECODE_CAPABILITIES_KHR

Extends VkStructureType.

Enum values:

• STRUCTURE_TYPE_VIDEO_DECODE_INFO_KHR
• STRUCTURE_TYPE_VIDEO_DECODE_CAPABILITIES_KHR
• STRUCTURE_TYPE_VIDEO_DECODE_USAGE_INFO_KHR

See Also:

• Constant Field Values

VK_STRUCTURE_TYPE_VIDEO_DECODE_USAGE_INFO_KHR

public static final int VK_STRUCTURE_TYPE_VIDEO_DECODE_USAGE_INFO_KHR

Extends VkStructureType.

Enum values:

• STRUCTURE_TYPE_VIDEO_DECODE_INFO_KHR
• STRUCTURE_TYPE_VIDEO_DECODE_CAPABILITIES_KHR
• STRUCTURE_TYPE_VIDEO_DECODE_USAGE_INFO_KHR

See Also:

• Constant Field Values

VK_QUEUE_VIDEO_DECODE_BIT_KHR

public static final int VK_QUEUE_VIDEO_DECODE_BIT_KHR

Extends VkQueueFlagBits.

See Also:

• Constant Field Values

VK_PIPELINE_STAGE_2_VIDEO_DECODE_BIT_KHR

public static final long VK_PIPELINE_STAGE_2_VIDEO_DECODE_BIT_KHR

Extends VkPipelineStageFlagBits2.

See Also:

• Constant Field Values

VK_ACCESS_2_VIDEO_DECODE_READ_BIT_KHR

public static final long VK_ACCESS_2_VIDEO_DECODE_READ_BIT_KHR

Extends VkAccessFlagBits2.

Enum values:

• ACCESS_2_VIDEO_DECODE_READ_BIT_KHR
• ACCESS_2_VIDEO_DECODE_WRITE_BIT_KHR

See Also:

• Constant Field Values

VK_ACCESS_2_VIDEO_DECODE_WRITE_BIT_KHR

public static final long VK_ACCESS_2_VIDEO_DECODE_WRITE_BIT_KHR

Extends VkAccessFlagBits2.

Enum values:

• ACCESS_2_VIDEO_DECODE_READ_BIT_KHR
• ACCESS_2_VIDEO_DECODE_WRITE_BIT_KHR

See Also:

• Constant Field Values

VK_BUFFER_USAGE_VIDEO_DECODE_SRC_BIT_KHR

public static final int VK_BUFFER_USAGE_VIDEO_DECODE_SRC_BIT_KHR

Extends VkBufferUsageFlagBits.

Enum values:

• BUFFER_USAGE_VIDEO_DECODE_SRC_BIT_KHR
• BUFFER_USAGE_VIDEO_DECODE_DST_BIT_KHR

See Also:

• Constant Field Values

VK_BUFFER_USAGE_VIDEO_DECODE_DST_BIT_KHR

public static final int VK_BUFFER_USAGE_VIDEO_DECODE_DST_BIT_KHR

Extends VkBufferUsageFlagBits.

Enum values:

• BUFFER_USAGE_VIDEO_DECODE_SRC_BIT_KHR
• BUFFER_USAGE_VIDEO_DECODE_DST_BIT_KHR

See Also:

• Constant Field Values

VK_IMAGE_USAGE_VIDEO_DECODE_DST_BIT_KHR

public static final int VK_IMAGE_USAGE_VIDEO_DECODE_DST_BIT_KHR

Extends VkImageUsageFlagBits.

Enum values:

• IMAGE_USAGE_VIDEO_DECODE_DST_BIT_KHR
• IMAGE_USAGE_VIDEO_DECODE_SRC_BIT_KHR
• IMAGE_USAGE_VIDEO_DECODE_DPB_BIT_KHR

See Also:

• Constant Field Values

VK_IMAGE_USAGE_VIDEO_DECODE_SRC_BIT_KHR

public static final int VK_IMAGE_USAGE_VIDEO_DECODE_SRC_BIT_KHR

Extends VkImageUsageFlagBits.

Enum values:

• IMAGE_USAGE_VIDEO_DECODE_DST_BIT_KHR
• IMAGE_USAGE_VIDEO_DECODE_SRC_BIT_KHR
• IMAGE_USAGE_VIDEO_DECODE_DPB_BIT_KHR

See Also:

• Constant Field Values

VK_IMAGE_USAGE_VIDEO_DECODE_DPB_BIT_KHR

public static final int VK_IMAGE_USAGE_VIDEO_DECODE_DPB_BIT_KHR

Extends VkImageUsageFlagBits.

Enum values:

• IMAGE_USAGE_VIDEO_DECODE_DST_BIT_KHR
• IMAGE_USAGE_VIDEO_DECODE_SRC_BIT_KHR
• IMAGE_USAGE_VIDEO_DECODE_DPB_BIT_KHR

See Also:

• Constant Field Values

VK_FORMAT_FEATURE_VIDEO_DECODE_OUTPUT_BIT_KHR

public static final int VK_FORMAT_FEATURE_VIDEO_DECODE_OUTPUT_BIT_KHR

Extends VkFormatFeatureFlagBits.

Enum values:

• FORMAT_FEATURE_VIDEO_DECODE_OUTPUT_BIT_KHR
• FORMAT_FEATURE_VIDEO_DECODE_DPB_BIT_KHR

See Also:

• Constant Field Values

VK_FORMAT_FEATURE_VIDEO_DECODE_DPB_BIT_KHR

public static final int VK_FORMAT_FEATURE_VIDEO_DECODE_DPB_BIT_KHR

Extends VkFormatFeatureFlagBits.

Enum values:

• FORMAT_FEATURE_VIDEO_DECODE_OUTPUT_BIT_KHR
• FORMAT_FEATURE_VIDEO_DECODE_DPB_BIT_KHR

See Also:

• Constant Field Values

VK_IMAGE_LAYOUT_VIDEO_DECODE_DST_KHR

public static final int VK_IMAGE_LAYOUT_VIDEO_DECODE_DST_KHR

Extends VkImageLayout.

Enum values:

• IMAGE_LAYOUT_VIDEO_DECODE_DST_KHR
• IMAGE_LAYOUT_VIDEO_DECODE_SRC_KHR
• IMAGE_LAYOUT_VIDEO_DECODE_DPB_KHR

See Also:

• Constant Field Values

VK_IMAGE_LAYOUT_VIDEO_DECODE_SRC_KHR

public static final int VK_IMAGE_LAYOUT_VIDEO_DECODE_SRC_KHR

Extends VkImageLayout.

Enum values:

• IMAGE_LAYOUT_VIDEO_DECODE_DST_KHR
• IMAGE_LAYOUT_VIDEO_DECODE_SRC_KHR
• IMAGE_LAYOUT_VIDEO_DECODE_DPB_KHR

See Also:

• Constant Field Values

VK_IMAGE_LAYOUT_VIDEO_DECODE_DPB_KHR

public static final int VK_IMAGE_LAYOUT_VIDEO_DECODE_DPB_KHR

Extends VkImageLayout.

Enum values:

• IMAGE_LAYOUT_VIDEO_DECODE_DST_KHR
• IMAGE_LAYOUT_VIDEO_DECODE_SRC_KHR
• IMAGE_LAYOUT_VIDEO_DECODE_DPB_KHR

See Also:

• Constant Field Values

VK_FORMAT_FEATURE_2_VIDEO_DECODE_OUTPUT_BIT_KHR

public static final long VK_FORMAT_FEATURE_2_VIDEO_DECODE_OUTPUT_BIT_KHR

Extends VkFormatFeatureFlagBits2.

Enum values:

• FORMAT_FEATURE_2_VIDEO_DECODE_OUTPUT_BIT_KHR
• FORMAT_FEATURE_2_VIDEO_DECODE_DPB_BIT_KHR

See Also:

• Constant Field Values

VK_FORMAT_FEATURE_2_VIDEO_DECODE_DPB_BIT_KHR

public static final long VK_FORMAT_FEATURE_2_VIDEO_DECODE_DPB_BIT_KHR

Extends VkFormatFeatureFlagBits2.

Enum values:

• FORMAT_FEATURE_2_VIDEO_DECODE_OUTPUT_BIT_KHR
• FORMAT_FEATURE_2_VIDEO_DECODE_DPB_BIT_KHR

See Also:

• Constant Field Values

VK_VIDEO_DECODE_CAPABILITY_DPB_AND_OUTPUT_COINCIDE_BIT_KHR

public static final int VK_VIDEO_DECODE_CAPABILITY_DPB_AND_OUTPUT_COINCIDE_BIT_KHR

VkVideoDecodeCapabilityFlagBitsKHR - Video decode capability flags

Description

• VIDEO_DECODE_CAPABILITY_DPB_AND_OUTPUT_COINCIDE_BIT_KHR indicates support for using the same video picture resource as the reconstructed picture and decode output picture in a video decode operation.
• VIDEO_DECODE_CAPABILITY_DPB_AND_OUTPUT_DISTINCT_BIT_KHR indicates support for using distinct video picture resources as the reconstructed picture and decode output picture in a video decode operation.

  Note

  Some video profiles allow using distinct video picture resources as the reconstructed picture and decode output picture in specific video decode operations even when the video decode profile does not support VIDEO_DECODE_CAPABILITY_DPB_AND_OUTPUT_DISTINCT_BIT_KHR. Even if the implementation only reports coincide, the decode output picture for film grain enabled frames must be a different video picture resource from the reconstructed picture because film grain is applied outside of the coding loop.

Implementations are only required to support one of VIDEO_DECODE_CAPABILITY_DPB_AND_OUTPUT_COINCIDE_BIT_KHR and VIDEO_DECODE_CAPABILITY_DPB_AND_OUTPUT_DISTINCT_BIT_KHR. Accordingly, applications should handle both cases to maximize portability.

Note

If both VIDEO_DECODE_CAPABILITY_DPB_AND_OUTPUT_COINCIDE_BIT_KHR and VIDEO_DECODE_CAPABILITY_DPB_AND_OUTPUT_DISTINCT_BIT_KHR are supported, an application can choose to create separate images for decode DPB and decode output. E.g. in cases when linear tiling is preferred (and supported) for the decode output picture and the DPB requires optimal tiling, this avoids the need for a separate copy at the expense of additional memory bandwidth requirements during decoding.

See Also:

• Constant Field Values

VK_VIDEO_DECODE_CAPABILITY_DPB_AND_OUTPUT_DISTINCT_BIT_KHR

public static final int VK_VIDEO_DECODE_CAPABILITY_DPB_AND_OUTPUT_DISTINCT_BIT_KHR

VkVideoDecodeCapabilityFlagBitsKHR - Video decode capability flags

Description

• VIDEO_DECODE_CAPABILITY_DPB_AND_OUTPUT_COINCIDE_BIT_KHR indicates support for using the same video picture resource as the reconstructed picture and decode output picture in a video decode operation.
• VIDEO_DECODE_CAPABILITY_DPB_AND_OUTPUT_DISTINCT_BIT_KHR indicates support for using distinct video picture resources as the reconstructed picture and decode output picture in a video decode operation.

  Note

  Some video profiles allow using distinct video picture resources as the reconstructed picture and decode output picture in specific video decode operations even when the video decode profile does not support VIDEO_DECODE_CAPABILITY_DPB_AND_OUTPUT_DISTINCT_BIT_KHR. Even if the implementation only reports coincide, the decode output picture for film grain enabled frames must be a different video picture resource from the reconstructed picture because film grain is applied outside of the coding loop.

Implementations are only required to support one of VIDEO_DECODE_CAPABILITY_DPB_AND_OUTPUT_COINCIDE_BIT_KHR and VIDEO_DECODE_CAPABILITY_DPB_AND_OUTPUT_DISTINCT_BIT_KHR. Accordingly, applications should handle both cases to maximize portability.

Note

If both VIDEO_DECODE_CAPABILITY_DPB_AND_OUTPUT_COINCIDE_BIT_KHR and VIDEO_DECODE_CAPABILITY_DPB_AND_OUTPUT_DISTINCT_BIT_KHR are supported, an application can choose to create separate images for decode DPB and decode output. E.g. in cases when linear tiling is preferred (and supported) for the decode output picture and the DPB requires optimal tiling, this avoids the need for a separate copy at the expense of additional memory bandwidth requirements during decoding.

See Also:

• Constant Field Values

VK_VIDEO_DECODE_USAGE_DEFAULT_KHR

public static final int VK_VIDEO_DECODE_USAGE_DEFAULT_KHR

VkVideoDecodeUsageFlagBitsKHR - Video decode usage flags

Description

• VIDEO_DECODE_USAGE_TRANSCODING_BIT_KHR specifies that video decoding is intended to be used in conjunction with video encoding to transcode a video bitstream with the same and/or different codecs.
• VIDEO_DECODE_USAGE_OFFLINE_BIT_KHR specifies that video decoding is intended to be used to consume a local video bitstream.
• VIDEO_DECODE_USAGE_STREAMING_BIT_KHR specifies that video decoding is intended to be used to consume a video bitstream received as a continuous flow over network.

Note

There are no restrictions on the combination of bits that can be specified by the application. However, applications should use reasonable combinations in order for the implementation to be able to select the most appropriate mode of operation for the particular use case.

Enum values:

• VIDEO_DECODE_USAGE_DEFAULT_KHR

See Also:

• Constant Field Values

VK_VIDEO_DECODE_USAGE_TRANSCODING_BIT_KHR

public static final int VK_VIDEO_DECODE_USAGE_TRANSCODING_BIT_KHR

VkVideoDecodeUsageFlagBitsKHR - Video decode usage flags

Description

• VIDEO_DECODE_USAGE_TRANSCODING_BIT_KHR specifies that video decoding is intended to be used in conjunction with video encoding to transcode a video bitstream with the same and/or different codecs.
• VIDEO_DECODE_USAGE_OFFLINE_BIT_KHR specifies that video decoding is intended to be used to consume a local video bitstream.
• VIDEO_DECODE_USAGE_STREAMING_BIT_KHR specifies that video decoding is intended to be used to consume a video bitstream received as a continuous flow over network.

Note

There are no restrictions on the combination of bits that can be specified by the application. However, applications should use reasonable combinations in order for the implementation to be able to select the most appropriate mode of operation for the particular use case.

Enum values:

• VIDEO_DECODE_USAGE_DEFAULT_KHR

See Also:

• Constant Field Values

VK_VIDEO_DECODE_USAGE_OFFLINE_BIT_KHR

public static final int VK_VIDEO_DECODE_USAGE_OFFLINE_BIT_KHR

VkVideoDecodeUsageFlagBitsKHR - Video decode usage flags

Description

• VIDEO_DECODE_USAGE_TRANSCODING_BIT_KHR specifies that video decoding is intended to be used in conjunction with video encoding to transcode a video bitstream with the same and/or different codecs.
• VIDEO_DECODE_USAGE_OFFLINE_BIT_KHR specifies that video decoding is intended to be used to consume a local video bitstream.
• VIDEO_DECODE_USAGE_STREAMING_BIT_KHR specifies that video decoding is intended to be used to consume a video bitstream received as a continuous flow over network.

Note

There are no restrictions on the combination of bits that can be specified by the application. However, applications should use reasonable combinations in order for the implementation to be able to select the most appropriate mode of operation for the particular use case.

Enum values:

• VIDEO_DECODE_USAGE_DEFAULT_KHR

See Also:

• Constant Field Values

VK_VIDEO_DECODE_USAGE_STREAMING_BIT_KHR

public static final int VK_VIDEO_DECODE_USAGE_STREAMING_BIT_KHR

VkVideoDecodeUsageFlagBitsKHR - Video decode usage flags

Description

• VIDEO_DECODE_USAGE_TRANSCODING_BIT_KHR specifies that video decoding is intended to be used in conjunction with video encoding to transcode a video bitstream with the same and/or different codecs.
• VIDEO_DECODE_USAGE_OFFLINE_BIT_KHR specifies that video decoding is intended to be used to consume a local video bitstream.
• VIDEO_DECODE_USAGE_STREAMING_BIT_KHR specifies that video decoding is intended to be used to consume a video bitstream received as a continuous flow over network.

Note

There are no restrictions on the combination of bits that can be specified by the application. However, applications should use reasonable combinations in order for the implementation to be able to select the most appropriate mode of operation for the particular use case.

Enum values:

• VIDEO_DECODE_USAGE_DEFAULT_KHR

See Also:

• Constant Field Values

Method Details

nvkCmdDecodeVideoKHR

public static void nvkCmdDecodeVideoKHR(org.lwjgl.vulkan.VkCommandBuffer commandBuffer,
 long pDecodeInfo)

Unsafe version of: CmdDecodeVideoKHR

vkCmdDecodeVideoKHR

public static void vkCmdDecodeVideoKHR(org.lwjgl.vulkan.VkCommandBuffer commandBuffer,
 VkVideoDecodeInfoKHR pDecodeInfo)

Launch a video decode operation.

C Specification

To launch video decode operations, call:

 void vkCmdDecodeVideoKHR(
     VkCommandBuffer                             commandBuffer,
     const VkVideoDecodeInfoKHR*                 pDecodeInfo);

Description

Each call issues one or more video decode operations. The implicit parameter opCount corresponds to the number of video decode operations issued by the command. After calling this command, the active query index of each active query is incremented by opCount.

Currently each call to this command results in the issue of a single video decode operation.

If the bound video session was created with VIDEO_SESSION_CREATE_INLINE_QUERIES_BIT_KHR and the pNext chain of pDecodeInfo includes a VkVideoInlineQueryInfoKHR structure with its queryPool member specifying a valid VkQueryPool handle, then this command will execute a query for each video decode operation issued by it.

Active Reference Picture Information

• The image subregion within the image subresource referred to by the video picture resource used as the reference picture.
• The DPB slot index the reference picture is associated with.
• The codec-specific reference information related to the reference picture.

Reconstructed Picture Information

• The image subregion within the image subresource referred to by the video picture resource used as the reconstructed picture.
• The DPB slot index to use for picture reconstruction.
• The codec-specific reference information related to the reconstructed picture.

Specifying a valid VkVideoReferenceSlotInfoKHR structure in pDecodeInfo→pSetupReferenceSlot is always required, unless the video session was created with VkVideoSessionCreateInfoKHR::maxDpbSlot equal to zero. However, the DPB slot identified by pDecodeInfo→pSetupReferenceSlot→slotIndex is only activated with the reconstructed picture specified in pDecodeInfo→pSetupReferenceSlot→pPictureResource if reference picture setup is requested according to the codec-specific semantics.

If reconstructed picture information is specified, and pDecodeInfo→pSetupReferenceSlot→pPictureResource refers to a video picture resource different than that of the decode output picture, but reference picture setup is not requested, the contents of the video picture resource corresponding to the reconstructed picture will be undefined after the video decode operation.

Note

Some implementations may always output the reconstructed picture or use it as temporary storage during the video decode operation even when the reconstructed picture is not marked for future reference.

Decode Output Picture Information

• The image subregion within the image subresource referred to by the video picture resource used as the decode output picture.
• The codec-specific picture information related to the decode output picture.

Several limiting values are defined below that are referenced by the relevant valid usage statements of this command.

• Let uint32_t activeReferencePictureCount be the size of the list of active reference pictures used by the video decode operation. Unless otherwise defined, activeReferencePictureCount is set to the value of pDecodeInfo→referenceSlotCount.
  • If the bound video session was created with an H.264 decode profile, then let activeReferencePictureCount be the value of pDecodeInfo→referenceSlotCount plus the number of elements of the pDecodeInfo→pReferenceSlots array that have a VkVideoDecodeH264DpbSlotInfoKHR structure included in their pNext chain with both pStdReferenceInfo→flags.top_field_flag and pStdReferenceInfo→flags.bottom_field_flag set.

    Note

    This means that the elements of pDecodeInfo→pReferenceSlots that include both a top and bottom field reference are counted as two separate active reference pictures, as described in the active reference picture list construction rules for H.264 decode operations.

• Let VkOffset2D codedOffsetGranularity be the minimum alignment requirement for the coded offset of video picture resources. Unless otherwise defined, the value of the x and y members of codedOffsetGranularity are 0.
  • If the bound video session was created with an H.264 decode profile with a VkVideoDecodeH264ProfileInfoKHR::pictureLayout of VIDEO_DECODE_H264_PICTURE_LAYOUT_INTERLACED_SEPARATE_PLANES_BIT_KHR, then codedOffsetGranularity is equal to VkVideoDecodeH264CapabilitiesKHR::fieldOffsetGranularity, as returned by GetPhysicalDeviceVideoCapabilitiesKHR for that video profile.
• Let uint32_t dpbFrameUseCount[] be an array of size maxDpbSlots, where maxDpbSlots is the VkVideoSessionCreateInfoKHR::maxDpbSlots the bound video session was created with, with each element indicating the number of times a frame associated with the corresponding DPB slot index is referred to by the video coding operation. Let the initial value of each element of the array be 0.
  • If pDecodeInfo→pSetupReferenceSlot is not NULL, then dpbFrameUseCount[i] is incremented by one, where i equals pDecodeInfo→pSetupReferenceSlot→slotIndex. If the bound video session object was created with an H.264 decode profile, then dpbFrameUseCount[i] is decremented by one if either pStdReferenceInfo→flags.top_field_flag or pStdReferenceInfo→flags.bottom_field_flag is set in the VkVideoDecodeH264DpbSlotInfoKHR structure in the pDecodeInfo→pSetupReferenceSlot→pNext chain.
  • For each element of pDecodeInfo→pReferenceSlots, dpbFrameUseCount[i] is incremented by one, where i equals the slotIndex member of the corresponding element. If the bound video session object was created with an H.264 decode profile, then dpbFrameUseCount[i] is decremented by one if either pStdReferenceInfo→flags.top_field_flag or pStdReferenceInfo→flags.bottom_field_flag is set in the VkVideoDecodeH264DpbSlotInfoKHR structure in the pNext chain of the corresponding element of pDecodeInfo→pReferenceSlots.
• Let uint32_t dpbTopFieldUseCount[] and uint32_t dpbBottomFieldUseCount[] be arrays of size maxDpbSlots, where maxDpbSlots is the VkVideoSessionCreateInfoKHR::maxDpbSlots the bound video session was created with, with each element indicating the number of times the top field or the bottom field, respectively, associated with the corresponding DPB slot index is referred to by the video coding operation. Let the initial value of each element of the arrays be 0.
  • If the bound video session object was created with an H.264 decode profile and pDecodeInfo→pSetupReferenceSlot is not NULL, then perform the following:
    • If pStdReferenceInfo→flags.top_field_flag is set in the VkVideoDecodeH264DpbSlotInfoKHR structure in the pDecodeInfo→pSetupReferenceSlot→pNext chain, then dpbTopFieldUseCount[i] is incremented by one, where i equals pDecodeInfo→pSetupReferenceSlot→slotIndex.
    • If pStdReferenceInfo→flags.bottom_field_flag is set in the VkVideoDecodeH264DpbSlotInfoKHR structure in the pDecodeInfo→pSetupReferenceSlot→pNext chain, then dpbBottomFieldUseCount[i] is incremented by one, where i equals pDecodeInfo→pSetupReferenceSlot→slotIndex.
  • If the bound video session object was created with an H.264 decode profile, then perform the following for each element of pDecodeInfo→pReferenceSlots:
    • If pStdReferenceInfo→flags.top_field_flag is set in the VkVideoDecodeH264DpbSlotInfoKHR structure in the pNext chain of the element, then dpbTopFieldUseCount[i] is incremented by one, where i equals the slotIndex member of the element.
    • If pStdReferenceInfo→flags.bottom_field_flag is set in the VkVideoDecodeH264DpbSlotInfoKHR structure in the pNext chain of the element, then dpbBottomFieldUseCount[i] is incremented by one, where i equals the slotIndex member of the element.

Valid Usage

• The bound video session must have been created with a decode operation
• The bound video session must not be in uninitialized state at the time the command is executed on the device
• For each active query, the active query index corresponding to the query type of that query plus opCount must be less than or equal to the last activatable query index corresponding to the query type of that query plus one
• If the bound video session was created with VIDEO_SESSION_CREATE_INLINE_QUERIES_BIT_KHR, and the pNext chain of pDecodeInfo includes a VkVideoInlineQueryInfoKHR structure with its queryPool member specifying a valid VkQueryPool handle, then VkVideoInlineQueryInfoKHR::queryCount must equal opCount
• If the bound video session was created with VIDEO_SESSION_CREATE_INLINE_QUERIES_BIT_KHR, and the pNext chain of pDecodeInfo includes a VkVideoInlineQueryInfoKHR structure with its queryPool member specifying a valid VkQueryPool handle, then all the queries used by the command, as specified by the VkVideoInlineQueryInfoKHR structure, must be unavailable
• If the bound video session was created with VIDEO_SESSION_CREATE_INLINE_QUERIES_BIT_KHR, then the queryType used to create the queryPool specified in the VkVideoInlineQueryInfoKHR structure included in the pNext chain of pDecodeInfo must be QUERY_TYPE_RESULT_STATUS_ONLY_KHR
• If the bound video session was created with VIDEO_SESSION_CREATE_INLINE_QUERIES_BIT_KHR, then the queryPool specified in the VkVideoInlineQueryInfoKHR structure included in the pNext chain of pDecodeInfo must have been created with a VkVideoProfileInfoKHR structure included in the pNext chain of VkQueryPoolCreateInfo identical to the one specified in VkVideoSessionCreateInfoKHR::pVideoProfile the bound video session was created with
• If the bound video session was created with VIDEO_SESSION_CREATE_INLINE_QUERIES_BIT_KHR, and the queryType used to create the queryPool specified in the VkVideoInlineQueryInfoKHR structure included in the pNext chain of pDecodeInfo is QUERY_TYPE_RESULT_STATUS_ONLY_KHR, then the VkCommandPool that commandBuffer was allocated from must have been created with a queue family index that supports result status queries, as indicated by VkQueueFamilyQueryResultStatusPropertiesKHR::queryResultStatusSupport
• pDecodeInfo→srcBuffer must be compatible with the video profile the bound video session was created with
• If commandBuffer is an unprotected command buffer and protectedNoFault is not supported, then pDecodeInfo→srcBuffer must not be a protected buffer
• pDecodeInfo→srcBufferOffset must be an integer multiple of VkVideoCapabilitiesKHR::minBitstreamBufferOffsetAlignment, as returned by GetPhysicalDeviceVideoCapabilitiesKHR for the video profile the bound video session was created with
• pDecodeInfo→srcBufferRange must be an integer multiple of VkVideoCapabilitiesKHR::minBitstreamBufferSizeAlignment, as returned by GetPhysicalDeviceVideoCapabilitiesKHR for the video profile the bound video session was created with
• If pDecodeInfo→pSetupReferenceSlot is not NULL and VkVideoDecodeCapabilitiesKHR::flags does not include VIDEO_DECODE_CAPABILITY_DPB_AND_OUTPUT_COINCIDE_BIT_KHR, as returned by GetPhysicalDeviceVideoCapabilitiesKHR for the video profile the bound video session was created with, then the video picture resources specified by pDecodeInfo→dstPictureResource and pDecodeInfo→pSetupReferenceSlot→pPictureResource must not match
• If pDecodeInfo→pSetupReferenceSlot is not NULL and none of the following is true:
  • VkVideoDecodeCapabilitiesKHR::flags includes VIDEO_DECODE_CAPABILITY_DPB_AND_OUTPUT_DISTINCT_BIT_KHR, as returned by GetPhysicalDeviceVideoCapabilitiesKHR for the video profile the bound video session was created with
  • the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_AV1_BIT_KHR and VkVideoDecodeAV1ProfileInfoKHR::filmGrainSupport set to TRUE, and film grain is enabled for the decoded picture

  then the video picture resources specified by pDecodeInfo→dstPictureResource and pDecodeInfo→pSetupReferenceSlot→pPictureResource must match

• pDecodeInfo→dstPictureResource.imageViewBinding must be compatible with the video profile the bound video session was created with
• The format of pDecodeInfo→dstPictureResource.imageViewBinding must match the VkVideoSessionCreateInfoKHR::pictureFormat the bound video session was created with
• pDecodeInfo→dstPictureResource.codedOffset must be an integer multiple of codedOffsetGranularity
• pDecodeInfo→dstPictureResource.codedExtent must be between minCodedExtent and maxCodedExtent, inclusive, the bound video session was created with
• pDecodeInfo→dstPictureResource.imageViewBinding must have been created with IMAGE_USAGE_VIDEO_DECODE_DST_BIT_KHR
• If commandBuffer is an unprotected command buffer and protectedNoFault is not supported, then pDecodeInfo→dstPictureResource.imageViewBinding must not have been created from a protected image
• If commandBuffer is a protected command buffer and protectedNoFault is not supported, then pDecodeInfo→dstPictureResource.imageViewBinding must have been created from a protected image
• pDecodeInfo→pSetupReferenceSlot must not be NULL unless the bound video session was created with VkVideoSessionCreateInfoKHR::maxDpbSlots equal to zero
• If pDecodeInfo→pSetupReferenceSlot is not NULL, then pDecodeInfo→pSetupReferenceSlot→slotIndex must be less than the VkVideoSessionCreateInfoKHR::maxDpbSlots specified when the bound video session was created
• If pDecodeInfo→pSetupReferenceSlot is not NULL, then pDecodeInfo→pSetupReferenceSlot→pPictureResource→codedOffset must be an integer multiple of codedOffsetGranularity
• If pDecodeInfo→pSetupReferenceSlot is not NULL, then pDecodeInfo→pSetupReferenceSlot→pPictureResource must match one of the bound reference picture resource
• activeReferencePictureCount must be less than or equal to the VkVideoSessionCreateInfoKHR::maxActiveReferencePictures specified when the bound video session was created
• The slotIndex member of each element of pDecodeInfo→pReferenceSlots must be less than the VkVideoSessionCreateInfoKHR::maxDpbSlots specified when the bound video session was created
• The codedOffset member of the VkVideoPictureResourceInfoKHR structure pointed to by the pPictureResource member of each element of pDecodeInfo→pReferenceSlots must be an integer multiple of codedOffsetGranularity
• The pPictureResource member of each element of pDecodeInfo→pReferenceSlots must match one of the bound reference picture resource associated with the DPB slot index specified in the slotIndex member of that element
• Each video picture resource corresponding to the pPictureResource member specified in the elements of pDecodeInfo→pReferenceSlots must be unique within pDecodeInfo→pReferenceSlots
• All elements of dpbFrameUseCount must be less than or equal to 1
• All elements of dpbTopFieldUseCount must be less than or equal to 1
• All elements of dpbBottomFieldUseCount must be less than or equal to 1
• If pDecodeInfo→pSetupReferenceSlot is NULL or pDecodeInfo→pSetupReferenceSlot→pPictureResource does not refer to the same image subresource as pDecodeInfo→dstPictureResource, then the image subresource referred to by pDecodeInfo→dstPictureResource must be in the IMAGE_LAYOUT_VIDEO_DECODE_DST_KHR layout at the time the video decode operation is executed on the device
• If pDecodeInfo→pSetupReferenceSlot is not NULL and pDecodeInfo→pSetupReferenceSlot→pPictureResource refers to the same image subresource as pDecodeInfo→dstPictureResource, then the image subresource referred to by pDecodeInfo→dstPictureResource must be in the IMAGE_LAYOUT_VIDEO_DECODE_DPB_KHR layout at the time the video decode operation is executed on the device
• If pDecodeInfo→pSetupReferenceSlot is not NULL, then the image subresource referred to by pDecodeInfo→pSetupReferenceSlot→pPictureResource must be in the IMAGE_LAYOUT_VIDEO_DECODE_DPB_KHR layout at the time the video decode operation is executed on the device
• The image subresource referred to by the pPictureResource member of each element of pDecodeInfo→pReferenceSlots must be in the IMAGE_LAYOUT_VIDEO_DECODE_DPB_KHR layout at the time the video decode operation is executed on the device
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_H264_BIT_KHR, then the pNext chain of pDecodeInfo must include a VkVideoDecodeH264PictureInfoKHR structure
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_H264_BIT_KHR but was not created with interlaced frame support, then the decode output picture must represent a frame
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_H264_BIT_KHR, then all elements of the pSliceOffsets member of the VkVideoDecodeH264PictureInfoKHR structure included in the pNext chain of pDecodeInfo must be less than pDecodeInfo→srcBufferRange
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_H264_BIT_KHR, then the bound video session parameters object must contain a StdVideoH264SequenceParameterSet entry with seq_parameter_set_id matching StdVideoDecodeH264PictureInfo::seq_parameter_set_id that is provided in the pStdPictureInfo member of the VkVideoDecodeH264PictureInfoKHR structure included in the pNext chain of pDecodeInfo
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_H264_BIT_KHR, then the bound video session parameters object must contain a StdVideoH264PictureParameterSet entry with seq_parameter_set_id and pic_parameter_set_id matching StdVideoDecodeH264PictureInfo::seq_parameter_set_id and StdVideoDecodeH264PictureInfo::pic_parameter_set_id, respectively, that are provided in the pStdPictureInfo member of the VkVideoDecodeH264PictureInfoKHR structure included in the pNext chain of pDecodeInfo
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_H264_BIT_KHR and pDecodeInfo→pSetupReferenceSlot is not NULL, then the pNext chain of pDecodeInfo→pSetupReferenceSlot must include a VkVideoDecodeH264DpbSlotInfoKHR structure
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_H264_BIT_KHR but was not created with interlaced frame support, and pDecodeInfo→pSetupReferenceSlot is not NULL, then the reconstructed picture must represent a frame
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_H264_BIT_KHR, then the pNext chain of each element of pDecodeInfo→pReferenceSlots must include a VkVideoDecodeH264DpbSlotInfoKHR structure
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_H264_BIT_KHR but was not created with interlaced frame support, then each active reference picture corresponding to the elements of pDecodeInfo→pReferenceSlots must represent a frame
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_H264_BIT_KHR, pDecodeInfo→pSetupReferenceSlot is not NULL, and the decode output picture represents a frame, then the reconstructed picture must also represent a frame
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_H264_BIT_KHR, pDecodeInfo→pSetupReferenceSlot is not NULL, and the decode output picture represents a top field, then the reconstructed picture must also represent a top field
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_H264_BIT_KHR, pDecodeInfo→pSetupReferenceSlot is not NULL, and the decode output picture represents a bottom field, then the reconstructed picture must also represent a bottom field
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_H264_BIT_KHR and an active reference picture corresponding to any element of pDecodeInfo→pReferenceSlots represents a frame, then the DPB slot index of the bound video session specified by the slotIndex member of that element must be currently associated with a frame picture matching the video picture resource specified by the pPictureResource member of the same element at the time the command is executed on the device
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_H264_BIT_KHR and an active reference picture corresponding to any element of pDecodeInfo→pReferenceSlots represents a top field, then the DPB slot index of the bound video session specified by the slotIndex member of that element must be currently associated with a top field picture matching the video picture resource specified by the pPictureResource member of the same element at the time the command is executed on the device
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_H264_BIT_KHR and an active reference picture corresponding to any element of pDecodeInfo→pReferenceSlots represents a bottom field, then the DPB slot index of the bound video session specified by the slotIndex member of that element must be currently associated with a bottom field picture matching the video picture resource specified by the pPictureResource member of the same element at the time the command is executed on the device
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_H265_BIT_KHR, then the pNext chain of pDecodeInfo must include a VkVideoDecodeH265PictureInfoKHR structure
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_H265_BIT_KHR, then all elements of the pSliceSegmentOffsets member of the VkVideoDecodeH265PictureInfoKHR structure included in the pNext chain of pDecodeInfo must be less than pDecodeInfo→srcBufferRange
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_H265_BIT_KHR, then the bound video session parameters object must contain a StdVideoH265VideoParameterSet entry with vps_video_parameter_set_id matching StdVideoDecodeH265PictureInfo::sps_video_parameter_set_id that is provided in the pStdPictureInfo member of the VkVideoDecodeH265PictureInfoKHR structure included in the pNext chain of pDecodeInfo
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_H265_BIT_KHR, then the bound video session parameters object must contain a StdVideoH265SequenceParameterSet entry with sps_video_parameter_set_id and sps_seq_parameter_set_id matching StdVideoDecodeH265PictureInfo::sps_video_parameter_set_id and StdVideoDecodeH265PictureInfo::pps_seq_parameter_set_id, respectively, that are provided in the pStdPictureInfo member of the VkVideoDecodeH265PictureInfoKHR structure included in the pNext chain of pDecodeInfo
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_H265_BIT_KHR, then the bound video session parameters object must contain a StdVideoH265PictureParameterSet entry with sps_video_parameter_set_id, pps_seq_parameter_set_id, and pps_pic_parameter_set_id matching StdVideoDecodeH265PictureInfo::sps_video_parameter_set_id, StdVideoDecodeH265PictureInfo::pps_seq_parameter_set_id, and StdVideoDecodeH265PictureInfo::pps_pic_parameter_set_id, respectively, that are provided in the pStdPictureInfo member of the VkVideoDecodeH265PictureInfoKHR structure included in the pNext chain of pDecodeInfo
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_H265_BIT_KHR and pDecodeInfo→pSetupReferenceSlot is not NULL, then the pNext chain of pDecodeInfo→pSetupReferenceSlot must include a VkVideoDecodeH265DpbSlotInfoKHR structure
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_H265_BIT_KHR, then the pNext chain of each element of pDecodeInfo→pReferenceSlots must include a VkVideoDecodeH265DpbSlotInfoKHR structure
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_AV1_BIT_KHR and VkVideoDecodeAV1ProfileInfoKHR::filmGrainSupport set to FALSE, then film grain must not be enabled for the decoded picture
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_AV1_BIT_KHR, pDecodeInfo→pSetupReferenceSlot is not NULL, and film grain is enabled for the decoded picture, then the video picture resources specified by pDecodeInfo→dstPictureResource and pDecodeInfo→pSetupReferenceSlot→pPictureResource must not match
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_AV1_BIT_KHR, then the pNext chain of pDecodeInfo must include a VkVideoDecodeAV1PictureInfoKHR structure
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_AV1_BIT_KHR, then the frameHeaderOffset member of the VkVideoDecodeAV1PictureInfoKHR structure included in the pNext chain of pDecodeInfo must be less than the minimum of pDecodeInfo→srcBufferRange
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_AV1_BIT_KHR, then all elements of the pTileOffsets member of the VkVideoDecodeAV1PictureInfoKHR structure included in the pNext chain of pDecodeInfo must be less than pDecodeInfo→srcBufferRange
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_AV1_BIT_KHR, then for each element i of the pTileOffsets and pTileSizes members of the VkVideoDecodeAV1PictureInfoKHR structure included in the pNext chain of pDecodeInfo the sum of pTileOffsets[i] and pTileSizes[i] must be less than or equal to pDecodeInfo→srcBufferRange
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_AV1_BIT_KHR and pDecodeInfo→pSetupReferenceSlot is not NULL, then the pNext chain of pDecodeInfo→pSetupReferenceSlot must include a VkVideoDecodeAV1DpbSlotInfoKHR structure
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_AV1_BIT_KHR, then the pNext chain of each element of pDecodeInfo→pReferenceSlots must include a VkVideoDecodeAV1DpbSlotInfoKHR structure
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_AV1_BIT_KHR, then each element of the referenceNameSlotIndices array member of the VkVideoDecodeAV1PictureInfoKHR structure included in the pNext chain of pDecodeInfo must either be negative or must equal the slotIndex member of one of the elements of pDecodeInfo→pReferenceSlots
• If the bound video session was created with the video codec operation VIDEO_CODEC_OPERATION_DECODE_AV1_BIT_KHR, then the slotIndex member of each element of pDecodeInfo→pReferenceSlots must equal one of the elements of the referenceNameSlotIndices array member of the VkVideoDecodeAV1PictureInfoKHR structure included in the pNext chain of pDecodeInfo

Valid Usage (Implicit)

• commandBuffer must be a valid VkCommandBuffer handle
• pDecodeInfo must be a valid pointer to a valid VkVideoDecodeInfoKHR structure
• commandBuffer must be in the recording state
• The VkCommandPool that commandBuffer was allocated from must support decode operations
• This command must only be called outside of a render pass instance
• This command must only be called inside of a video coding scope
• commandBuffer must be a primary VkCommandBuffer

Host Synchronization

• Host access to commandBuffer must be externally synchronized
• Host access to the VkCommandPool that commandBuffer was allocated from must be externally synchronized

Command Properties

Command Buffer Levels	Render Pass Scope	Video Coding Scope	Supported Queue Types	Command Type
Primary	Outside	Inside	Decode	Action

See Also

VkVideoDecodeInfoKHR

Parameters:

commandBuffer - the command buffer in which to record the command.

pDecodeInfo - a pointer to a VkVideoDecodeInfoKHR structure specifying the parameters of the video decode operations.