[{"data":1,"prerenderedAt":900},["ShallowReactive",2],{"hSyKP4SUHG":3},{"title":4,"description":5,"parent":6,"cmd_buf_level":7,"render_pass_scope":10,"supported_queue_types":11,"tasks":17,"type":19,"xrefs":20,"body":21,"_type":899,"_id":4},"vkCmdResetQueryPool","Reset queries in a query pool","VK_VERSION_1_0",[8,9],"primary","secondary","outside",[12,13,14,15,16],"graphics","compute","decode","encode","opticalflow",[18],"action","protos",[],{"type":22,"children":23,"toc":897},"root",[24,32,289,336,362,367,410,444,449,511,554,678,845,891],{"type":25,"tag":26,"props":27,"children":28},"element","p",{},[29],{"type":30,"value":31},"text","To reset a range of queries in a query pool on a queue, call:",{"type":25,"tag":33,"props":34,"children":35},"code-group",{},[36,147],{"type":25,"tag":37,"props":38,"children":44},"pre",{"className":39,"code":40,"filename":41,"language":42,"meta":43,"style":43},"language-c shiki shiki-themes github-light-default github-dark-default","void vkCmdResetQueryPool(\n    VkCommandBuffer commandBuffer,\n    VkQueryPool queryPool,\n    uint32_t firstQuery,\n    uint32_t queryCount);\n","C","c","",[45],{"type":25,"tag":46,"props":47,"children":48},"code",{"__ignoreMap":43},[49,73,93,111,129],{"type":25,"tag":50,"props":51,"children":54},"span",{"class":52,"line":53},"line",1,[55,61,67],{"type":25,"tag":50,"props":56,"children":58},{"style":57},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[59],{"type":30,"value":60},"void",{"type":25,"tag":50,"props":62,"children":64},{"style":63},"--shiki-default:#8250DF;--shiki-dark:#D2A8FF",[65],{"type":30,"value":66}," vkCmdResetQueryPool",{"type":25,"tag":50,"props":68,"children":70},{"style":69},"--shiki-default:#1F2328;--shiki-dark:#E6EDF3",[71],{"type":30,"value":72},"(\n",{"type":25,"tag":50,"props":74,"children":76},{"class":52,"line":75},2,[77,82,88],{"type":25,"tag":50,"props":78,"children":79},{"style":69},[80],{"type":30,"value":81},"    VkCommandBuffer ",{"type":25,"tag":50,"props":83,"children":85},{"style":84},"--shiki-default:#953800;--shiki-dark:#FFA657",[86],{"type":30,"value":87},"commandBuffer",{"type":25,"tag":50,"props":89,"children":90},{"style":69},[91],{"type":30,"value":92},",\n",{"type":25,"tag":50,"props":94,"children":96},{"class":52,"line":95},3,[97,102,107],{"type":25,"tag":50,"props":98,"children":99},{"style":69},[100],{"type":30,"value":101},"    VkQueryPool ",{"type":25,"tag":50,"props":103,"children":104},{"style":84},[105],{"type":30,"value":106},"queryPool",{"type":25,"tag":50,"props":108,"children":109},{"style":69},[110],{"type":30,"value":92},{"type":25,"tag":50,"props":112,"children":114},{"class":52,"line":113},4,[115,120,125],{"type":25,"tag":50,"props":116,"children":117},{"style":57},[118],{"type":30,"value":119},"    uint32_t",{"type":25,"tag":50,"props":121,"children":122},{"style":84},[123],{"type":30,"value":124}," firstQuery",{"type":25,"tag":50,"props":126,"children":127},{"style":69},[128],{"type":30,"value":92},{"type":25,"tag":50,"props":130,"children":132},{"class":52,"line":131},5,[133,137,142],{"type":25,"tag":50,"props":134,"children":135},{"style":57},[136],{"type":30,"value":119},{"type":25,"tag":50,"props":138,"children":139},{"style":84},[140],{"type":30,"value":141}," queryCount",{"type":25,"tag":50,"props":143,"children":144},{"style":69},[145],{"type":30,"value":146},");\n",{"type":25,"tag":37,"props":148,"children":153},{"className":149,"code":150,"filename":151,"language":152,"meta":43,"style":43},"language-rs shiki shiki-themes github-light-default github-dark-default","pub fn cmd_reset_query_pool(\n    command_buffer: vk::CommandBuffer,\n    query_pool: vk::QueryPool,\n    first_query: u32,\n    query_count: u32,\n);\n","Rust","rs",[154],{"type":25,"tag":46,"props":155,"children":156},{"__ignoreMap":43},[157,179,211,240,261,281],{"type":25,"tag":50,"props":158,"children":159},{"class":52,"line":53},[160,165,170,175],{"type":25,"tag":50,"props":161,"children":162},{"style":57},[163],{"type":30,"value":164},"pub",{"type":25,"tag":50,"props":166,"children":167},{"style":57},[168],{"type":30,"value":169}," fn",{"type":25,"tag":50,"props":171,"children":172},{"style":63},[173],{"type":30,"value":174}," cmd_reset_query_pool",{"type":25,"tag":50,"props":176,"children":177},{"style":69},[178],{"type":30,"value":72},{"type":25,"tag":50,"props":180,"children":181},{"class":52,"line":75},[182,187,192,197,202,207],{"type":25,"tag":50,"props":183,"children":184},{"style":69},[185],{"type":30,"value":186},"    command_buffer",{"type":25,"tag":50,"props":188,"children":189},{"style":57},[190],{"type":30,"value":191},":",{"type":25,"tag":50,"props":193,"children":194},{"style":84},[195],{"type":30,"value":196}," vk",{"type":25,"tag":50,"props":198,"children":199},{"style":57},[200],{"type":30,"value":201},"::",{"type":25,"tag":50,"props":203,"children":204},{"style":84},[205],{"type":30,"value":206},"CommandBuffer",{"type":25,"tag":50,"props":208,"children":209},{"style":69},[210],{"type":30,"value":92},{"type":25,"tag":50,"props":212,"children":213},{"class":52,"line":95},[214,219,223,227,231,236],{"type":25,"tag":50,"props":215,"children":216},{"style":69},[217],{"type":30,"value":218},"    query_pool",{"type":25,"tag":50,"props":220,"children":221},{"style":57},[222],{"type":30,"value":191},{"type":25,"tag":50,"props":224,"children":225},{"style":84},[226],{"type":30,"value":196},{"type":25,"tag":50,"props":228,"children":229},{"style":57},[230],{"type":30,"value":201},{"type":25,"tag":50,"props":232,"children":233},{"style":84},[234],{"type":30,"value":235},"QueryPool",{"type":25,"tag":50,"props":237,"children":238},{"style":69},[239],{"type":30,"value":92},{"type":25,"tag":50,"props":241,"children":242},{"class":52,"line":113},[243,248,252,257],{"type":25,"tag":50,"props":244,"children":245},{"style":69},[246],{"type":30,"value":247},"    first_query",{"type":25,"tag":50,"props":249,"children":250},{"style":57},[251],{"type":30,"value":191},{"type":25,"tag":50,"props":253,"children":254},{"style":84},[255],{"type":30,"value":256}," u32",{"type":25,"tag":50,"props":258,"children":259},{"style":69},[260],{"type":30,"value":92},{"type":25,"tag":50,"props":262,"children":263},{"class":52,"line":131},[264,269,273,277],{"type":25,"tag":50,"props":265,"children":266},{"style":69},[267],{"type":30,"value":268},"    query_count",{"type":25,"tag":50,"props":270,"children":271},{"style":57},[272],{"type":30,"value":191},{"type":25,"tag":50,"props":274,"children":275},{"style":84},[276],{"type":30,"value":256},{"type":25,"tag":50,"props":278,"children":279},{"style":69},[280],{"type":30,"value":92},{"type":25,"tag":50,"props":282,"children":284},{"class":52,"line":283},6,[285],{"type":25,"tag":50,"props":286,"children":287},{"style":69},[288],{"type":30,"value":146},{"type":25,"tag":290,"props":291,"children":292},"ul",{},[293,304,314,325],{"type":25,"tag":294,"props":295,"children":296},"li",{},[297,302],{"type":25,"tag":46,"props":298,"children":300},{"className":299},[],[301],{"type":30,"value":87},{"type":30,"value":303}," is the command buffer into which this command will\nbe recorded.",{"type":25,"tag":294,"props":305,"children":306},{},[307,312],{"type":25,"tag":46,"props":308,"children":310},{"className":309},[],[311],{"type":30,"value":106},{"type":30,"value":313}," is the handle of the query pool managing the queries\nbeing reset.",{"type":25,"tag":294,"props":315,"children":316},{},[317,323],{"type":25,"tag":46,"props":318,"children":320},{"className":319},[],[321],{"type":30,"value":322},"firstQuery",{"type":30,"value":324}," is the initial query index to reset.",{"type":25,"tag":294,"props":326,"children":327},{},[328,334],{"type":25,"tag":46,"props":329,"children":331},{"className":330},[],[332],{"type":30,"value":333},"queryCount",{"type":30,"value":335}," is the number of queries to reset.",{"type":25,"tag":26,"props":337,"children":338},{},[339,341,346,348,353,355,360],{"type":30,"value":340},"When executed on a queue, this command sets the status of query indices\n[",{"type":25,"tag":46,"props":342,"children":344},{"className":343},[],[345],{"type":30,"value":322},{"type":30,"value":347},", ",{"type":25,"tag":46,"props":349,"children":351},{"className":350},[],[352],{"type":30,"value":322},{"type":30,"value":354}," +  ",{"type":25,"tag":46,"props":356,"children":358},{"className":357},[],[359],{"type":30,"value":333},{"type":30,"value":361}," - 1] to\nunavailable.",{"type":25,"tag":26,"props":363,"children":364},{},[365],{"type":30,"value":366},"This command defines an execution dependency between other query commands\nthat reference the same query.",{"type":25,"tag":26,"props":368,"children":369},{},[370,372,379,381,386,388,393,395,400,402,408],{"type":30,"value":371},"The first ",{"type":25,"tag":373,"props":374,"children":376},"a",{"href":375},"/chapters/synchronization#synchronization-dependencies-scopes",[377],{"type":30,"value":378},"synchronization scope",{"type":30,"value":380},"\nincludes all commands which reference the queries in ",{"type":25,"tag":46,"props":382,"children":384},{"className":383},[],[385],{"type":30,"value":106},{"type":30,"value":387},"\nindicated by ",{"type":25,"tag":46,"props":389,"children":391},{"className":390},[],[392],{"type":30,"value":322},{"type":30,"value":394}," and ",{"type":25,"tag":46,"props":396,"children":398},{"className":397},[],[399],{"type":30,"value":333},{"type":30,"value":401}," that occur earlier in\n",{"type":25,"tag":373,"props":403,"children":405},{"href":404},"/chapters/synchronization#synchronization-submission-order",[406],{"type":30,"value":407},"submission order",{"type":30,"value":409},".",{"type":25,"tag":26,"props":411,"children":412},{},[413,415,419,420,425,426,431,432,437,439,443],{"type":30,"value":414},"The second ",{"type":25,"tag":373,"props":416,"children":417},{"href":375},[418],{"type":30,"value":378},{"type":30,"value":380},{"type":25,"tag":46,"props":421,"children":423},{"className":422},[],[424],{"type":30,"value":106},{"type":30,"value":387},{"type":25,"tag":46,"props":427,"children":429},{"className":428},[],[430],{"type":30,"value":322},{"type":30,"value":394},{"type":25,"tag":46,"props":433,"children":435},{"className":434},[],[436],{"type":30,"value":333},{"type":30,"value":438}," that occur later in\n",{"type":25,"tag":373,"props":440,"children":441},{"href":404},[442],{"type":30,"value":407},{"type":30,"value":409},{"type":25,"tag":26,"props":445,"children":446},{},[447],{"type":30,"value":448},"The operation of this command happens after the first scope and happens\nbefore the second scope.",{"type":25,"tag":26,"props":450,"children":451},{},[452,454,460,462,467,469,475,477,482,483,488,490,495,497,502,504,510],{"type":30,"value":453},"If the ",{"type":25,"tag":46,"props":455,"children":457},{"className":456},[],[458],{"type":30,"value":459},"queryType",{"type":30,"value":461}," used to create ",{"type":25,"tag":46,"props":463,"children":465},{"className":464},[],[466],{"type":30,"value":106},{"type":30,"value":468}," was\n",{"type":25,"tag":46,"props":470,"children":472},{"className":471},[],[473],{"type":30,"value":474},"VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR",{"type":30,"value":476},", this command sets the status of\nquery indices [",{"type":25,"tag":46,"props":478,"children":480},{"className":479},[],[481],{"type":30,"value":322},{"type":30,"value":347},{"type":25,"tag":46,"props":484,"children":486},{"className":485},[],[487],{"type":30,"value":322},{"type":30,"value":489}," +\n",{"type":25,"tag":46,"props":491,"children":493},{"className":492},[],[494],{"type":30,"value":333},{"type":30,"value":496}," - 1] to unavailable for each pass of ",{"type":25,"tag":46,"props":498,"children":500},{"className":499},[],[501],{"type":30,"value":106},{"type":30,"value":503},", as\nindicated by a call to\n",{"type":25,"tag":373,"props":505,"children":507},{"href":506},"/man/vkGetPhysicalDeviceQueueFamilyPerformanceQueryPassesKHR",[508],{"type":30,"value":509},"vkGetPhysicalDeviceQueueFamilyPerformanceQueryPassesKHR",{"type":30,"value":409},{"type":25,"tag":512,"props":513,"children":514},"note",{},[515],{"type":25,"tag":26,"props":516,"children":517},{},[518,520,525,527,532,534,539,541,546,548,552],{"type":30,"value":519},"Because ",{"type":25,"tag":46,"props":521,"children":523},{"className":522},[],[524],{"type":30,"value":4},{"type":30,"value":526}," resets all the passes of the indicated\nqueries, applications must not record a ",{"type":25,"tag":46,"props":528,"children":530},{"className":529},[],[531],{"type":30,"value":4},{"type":30,"value":533}," command\nfor a ",{"type":25,"tag":46,"props":535,"children":537},{"className":536},[],[538],{"type":30,"value":106},{"type":30,"value":540}," created with ",{"type":25,"tag":46,"props":542,"children":544},{"className":543},[],[545],{"type":30,"value":474},{"type":30,"value":547},"\nin a command buffer that needs to be submitted multiple times as indicated\nby a call to ",{"type":25,"tag":373,"props":549,"children":550},{"href":506},[551],{"type":30,"value":509},{"type":30,"value":553},".\nOtherwise applications will never be able to complete the recorded queries.",{"type":25,"tag":555,"props":556,"children":558},"validity-group",{"name":557},"Valid Usage",[559,586,617,631],{"type":25,"tag":560,"props":561,"children":563},"validity-field",{"name":562},"VUID-vkCmdResetQueryPool-firstQuery-09436",[564],{"type":25,"tag":26,"props":565,"children":566},{},[567,572,574,579,581],{"type":25,"tag":46,"props":568,"children":570},{"className":569},[],[571],{"type":30,"value":322},{"type":30,"value":573}," ",{"type":25,"tag":575,"props":576,"children":578},"normative",{"type":577},"must",[],{"type":30,"value":580}," be less than the number of queries in\n",{"type":25,"tag":46,"props":582,"children":584},{"className":583},[],[585],{"type":30,"value":106},{"type":25,"tag":560,"props":587,"children":589},{"name":588},"VUID-vkCmdResetQueryPool-firstQuery-09437",[590],{"type":25,"tag":26,"props":591,"children":592},{},[593,595,600,601,606,607,610,612],{"type":30,"value":594},"The sum of ",{"type":25,"tag":46,"props":596,"children":598},{"className":597},[],[599],{"type":30,"value":322},{"type":30,"value":394},{"type":25,"tag":46,"props":602,"children":604},{"className":603},[],[605],{"type":30,"value":333},{"type":30,"value":573},{"type":25,"tag":575,"props":608,"children":609},{"type":577},[],{"type":30,"value":611}," be less than or\nequal to the number of queries in ",{"type":25,"tag":46,"props":613,"children":615},{"className":614},[],[616],{"type":30,"value":106},{"type":25,"tag":560,"props":618,"children":620},{"name":619},"VUID-vkCmdResetQueryPool-None-02841",[621],{"type":25,"tag":26,"props":622,"children":623},{},[624,626,629],{"type":30,"value":625},"All queries used by the command ",{"type":25,"tag":575,"props":627,"children":628},{"type":577},[],{"type":30,"value":630}," not be active",{"type":25,"tag":560,"props":632,"children":634},{"name":633},"VUID-vkCmdResetQueryPool-firstQuery-02862",[635],{"type":25,"tag":26,"props":636,"children":637},{},[638,640,645,647,652,654,657,659,664,665,670,671,676],{"type":30,"value":639},"If ",{"type":25,"tag":46,"props":641,"children":643},{"className":642},[],[644],{"type":30,"value":106},{"type":30,"value":646}," was created with\n",{"type":25,"tag":46,"props":648,"children":650},{"className":649},[],[651],{"type":30,"value":474},{"type":30,"value":653},", this command ",{"type":25,"tag":575,"props":655,"children":656},{"type":577},[],{"type":30,"value":658}," not be\nrecorded in a command buffer that, either directly or through secondary\ncommand buffers, also contains begin commands for a query from the set\nof queries [",{"type":25,"tag":46,"props":660,"children":662},{"className":661},[],[663],{"type":30,"value":322},{"type":30,"value":347},{"type":25,"tag":46,"props":666,"children":668},{"className":667},[],[669],{"type":30,"value":322},{"type":30,"value":489},{"type":25,"tag":46,"props":672,"children":674},{"className":673},[],[675],{"type":30,"value":333},{"type":30,"value":677}," - 1]",{"type":25,"tag":555,"props":679,"children":681},{"name":680},"Valid Usage (Implicit)",[682,708,732,756,785,799,812],{"type":25,"tag":560,"props":683,"children":685},{"name":684},"VUID-vkCmdResetQueryPool-commandBuffer-parameter",[686],{"type":25,"tag":26,"props":687,"children":688},{},[689,694,695,698,700,706],{"type":25,"tag":46,"props":690,"children":692},{"className":691},[],[693],{"type":30,"value":87},{"type":30,"value":573},{"type":25,"tag":575,"props":696,"children":697},{"type":577},[],{"type":30,"value":699}," be a valid ",{"type":25,"tag":373,"props":701,"children":703},{"href":702},"/man/VkCommandBuffer",[704],{"type":30,"value":705},"VkCommandBuffer",{"type":30,"value":707}," handle",{"type":25,"tag":560,"props":709,"children":711},{"name":710},"VUID-vkCmdResetQueryPool-queryPool-parameter",[712],{"type":25,"tag":26,"props":713,"children":714},{},[715,720,721,724,725,731],{"type":25,"tag":46,"props":716,"children":718},{"className":717},[],[719],{"type":30,"value":106},{"type":30,"value":573},{"type":25,"tag":575,"props":722,"children":723},{"type":577},[],{"type":30,"value":699},{"type":25,"tag":373,"props":726,"children":728},{"href":727},"/man/VkQueryPool",[729],{"type":30,"value":730},"VkQueryPool",{"type":30,"value":707},{"type":25,"tag":560,"props":733,"children":735},{"name":734},"VUID-vkCmdResetQueryPool-commandBuffer-recording",[736],{"type":25,"tag":26,"props":737,"children":738},{},[739,744,745,748,750],{"type":25,"tag":46,"props":740,"children":742},{"className":741},[],[743],{"type":30,"value":87},{"type":30,"value":573},{"type":25,"tag":575,"props":746,"children":747},{"type":577},[],{"type":30,"value":749}," be in the ",{"type":25,"tag":373,"props":751,"children":753},{"href":752},"/chapters/commandbuffers#commandbuffers-lifecycle",[754],{"type":30,"value":755},"recording state",{"type":25,"tag":560,"props":757,"children":759},{"name":758},"VUID-vkCmdResetQueryPool-commandBuffer-cmdpool",[760],{"type":25,"tag":26,"props":761,"children":762},{},[763,765,771,773,778,780,783],{"type":30,"value":764},"The ",{"type":25,"tag":46,"props":766,"children":768},{"className":767},[],[769],{"type":30,"value":770},"VkCommandPool",{"type":30,"value":772}," that ",{"type":25,"tag":46,"props":774,"children":776},{"className":775},[],[777],{"type":30,"value":87},{"type":30,"value":779}," was allocated from ",{"type":25,"tag":575,"props":781,"children":782},{"type":577},[],{"type":30,"value":784}," support graphics, compute, decode, encode, or optical flow operations",{"type":25,"tag":560,"props":786,"children":788},{"name":787},"VUID-vkCmdResetQueryPool-renderpass",[789],{"type":25,"tag":26,"props":790,"children":791},{},[792,794,797],{"type":30,"value":793},"This command ",{"type":25,"tag":575,"props":795,"children":796},{"type":577},[],{"type":30,"value":798}," only be called outside of a render pass instance",{"type":25,"tag":560,"props":800,"children":802},{"name":801},"VUID-vkCmdResetQueryPool-videocoding",[803],{"type":25,"tag":26,"props":804,"children":805},{},[806,807,810],{"type":30,"value":793},{"type":25,"tag":575,"props":808,"children":809},{"type":577},[],{"type":30,"value":811}," only be called outside of a video coding scope",{"type":25,"tag":560,"props":813,"children":815},{"name":814},"VUID-vkCmdResetQueryPool-commonparent",[816],{"type":25,"tag":26,"props":817,"children":818},{},[819,821,826,828,833,834,837,839],{"type":30,"value":820},"Both of ",{"type":25,"tag":46,"props":822,"children":824},{"className":823},[],[825],{"type":30,"value":87},{"type":30,"value":827},", and ",{"type":25,"tag":46,"props":829,"children":831},{"className":830},[],[832],{"type":30,"value":106},{"type":30,"value":573},{"type":25,"tag":575,"props":835,"children":836},{"type":577},[],{"type":30,"value":838}," have been created, allocated, or retrieved from the same ",{"type":25,"tag":373,"props":840,"children":842},{"href":841},"/man/VkDevice",[843],{"type":30,"value":844},"VkDevice",{"type":25,"tag":846,"props":847,"children":849},"validity-box",{"name":848},"Host Synchronization",[850],{"type":25,"tag":290,"props":851,"children":852},{},[853,869],{"type":25,"tag":294,"props":854,"children":855},{},[856,858,863,864,867],{"type":30,"value":857},"Host access to ",{"type":25,"tag":46,"props":859,"children":861},{"className":860},[],[862],{"type":30,"value":87},{"type":30,"value":573},{"type":25,"tag":575,"props":865,"children":866},{"type":577},[],{"type":30,"value":868}," be externally synchronized",{"type":25,"tag":294,"props":870,"children":871},{},[872,874,879,880,885,886,889],{"type":30,"value":873},"Host access to the ",{"type":25,"tag":46,"props":875,"children":877},{"className":876},[],[878],{"type":30,"value":770},{"type":30,"value":772},{"type":25,"tag":46,"props":881,"children":883},{"className":882},[],[884],{"type":30,"value":87},{"type":30,"value":779},{"type":25,"tag":575,"props":887,"children":888},{"type":577},[],{"type":30,"value":890}," be externally synchronized\n::",{"type":25,"tag":892,"props":893,"children":894},"style",{},[895],{"type":30,"value":896},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":43,"searchDepth":75,"depth":75,"links":898},[],"markdown",1725732607424]