VkVideoInlineQueryInfoKHR
The VkVideoInlineQueryInfoKHR
structure is defined as:
typedef struct VkVideoInlineQueryInfoKHR {
VkStructureType sType;
const void* pNext;
VkQueryPool queryPool;
uint32_t firstQuery;
uint32_t queryCount;
} VkVideoInlineQueryInfoKHR;
sType
is a VkStructureType value identifying this structure.pNext
isNULL
or a pointer to a structure extending this structure.queryPool
isVK_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.In practice, if
queryPool
is notVK_NULL_HANDLE
, thenqueryCount
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.
This structure can be included in the pNext
chain of the input
parameter structure of video coding commands.
- In the
pNext
chain of thepDecodeInfo
parameter of the vkCmdDecodeVideoKHR command to execute a query for each video decode operation issued by the command. - In the
pNext
chain of thepEncodeInfo
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