C Specification

The VkVideoInlineQueryInfoKHR structure is defined as:

// Provided by VK_KHR_video_maintenance1
typedef struct VkVideoInlineQueryInfoKHR {
    VkStructureType    sType;
    const void*        pNext;
    VkQueryPool        queryPool;
    uint32_t           firstQuery;
    uint32_t           queryCount;
} VkVideoInlineQueryInfoKHR;

Members

  • sType is a VkStructureType value identifying this structure.

  • pNext is NULL or a pointer to a structure extending this structure.

  • queryPool is VK_NULL_HANDLE or a valid handle to a VkQueryPool object that will manage the results of the queries.

  • firstQuery is the query index within the query pool that will contain the query results for the first video coding operation. The query results of subsequent video coding operations will be contained by subsequent query indices.

  • queryCount is the number of queries to execute.

    Note

    In practice, if queryPool is not VK_NULL_HANDLE, then queryCount will always have to match the number of video coding operations issued by the video coding command this structure is specified to, meaning that using inline queries in a video coding command will always execute a query for each issued video coding operation.

Description

This structure can be included in the pNext chain of the input parameter structure of video coding commands.

  • In the pNext chain of the pDecodeInfo parameter of the vkCmdDecodeVideoKHR command to execute a query for each video decode operation issued by the command.

  • In the pNext chain of the pEncodeInfo parameter of the vkCmdEncodeVideoKHR command to execute a query for each video encode operation issued by the command.

Valid Usage

  • VUID-VkVideoInlineQueryInfoKHR-queryPool-08372
    If queryPool is not VK_NULL_HANDLE, then firstQuery must be less than the number of queries in queryPool

  • VUID-VkVideoInlineQueryInfoKHR-queryPool-08373
    If queryPool is not VK_NULL_HANDLE, then the sum of firstQuery and queryCount must be less than or equal to the number of queries in queryPool

Valid Usage (Implicit)

  • VUID-VkVideoInlineQueryInfoKHR-sType-sType
    sType must be VK_STRUCTURE_TYPE_VIDEO_INLINE_QUERY_INFO_KHR

  • VUID-VkVideoInlineQueryInfoKHR-queryPool-parameter
    If queryPool is not VK_NULL_HANDLE, queryPool must be a valid VkQueryPool handle

See Also

VK_KHR_video_maintenance1, VkQueryPool, VkStructureType

Document Notes

For more information, see the Vulkan Specification

This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.

Copyright

Copyright 2014-2024 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0