[{"data":1,"prerenderedAt":476},["ShallowReactive",2],{"fRG9R9Waxk":3},{"title":4,"description":5,"parent":6,"cmd_buf_level":7,"render_pass_scope":10,"supported_queue_types":11,"tasks":14,"type":17,"xrefs":18,"body":19,"_type":475,"_id":4},"vkCmdEndDebugUtilsLabelEXT","Close a command buffer label region","VK_EXT_debug_utils",[8,9],"primary","secondary","both",[12,13],"graphics","compute",[15,16],"action","state","protos",[],{"type":20,"children":21,"toc":473},"root",[22,30,164,179,213,244,324,421,467],{"type":23,"tag":24,"props":25,"children":26},"element","p",{},[27],{"type":28,"value":29},"text","A command buffer label region can be closed by calling:",{"type":23,"tag":31,"props":32,"children":33},"code-group",{},[34,91],{"type":23,"tag":35,"props":36,"children":42},"pre",{"className":37,"code":38,"filename":39,"language":40,"meta":41,"style":41},"language-c shiki shiki-themes github-light-default github-dark-default","void vkCmdEndDebugUtilsLabelEXT(\n    VkCommandBuffer commandBuffer);\n","C","c","",[43],{"type":23,"tag":44,"props":45,"children":46},"code",{"__ignoreMap":41},[47,71],{"type":23,"tag":48,"props":49,"children":52},"span",{"class":50,"line":51},"line",1,[53,59,65],{"type":23,"tag":48,"props":54,"children":56},{"style":55},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[57],{"type":28,"value":58},"void",{"type":23,"tag":48,"props":60,"children":62},{"style":61},"--shiki-default:#8250DF;--shiki-dark:#D2A8FF",[63],{"type":28,"value":64}," vkCmdEndDebugUtilsLabelEXT",{"type":23,"tag":48,"props":66,"children":68},{"style":67},"--shiki-default:#1F2328;--shiki-dark:#E6EDF3",[69],{"type":28,"value":70},"(\n",{"type":23,"tag":48,"props":72,"children":74},{"class":50,"line":73},2,[75,80,86],{"type":23,"tag":48,"props":76,"children":77},{"style":67},[78],{"type":28,"value":79},"    VkCommandBuffer ",{"type":23,"tag":48,"props":81,"children":83},{"style":82},"--shiki-default:#953800;--shiki-dark:#FFA657",[84],{"type":28,"value":85},"commandBuffer",{"type":23,"tag":48,"props":87,"children":88},{"style":67},[89],{"type":28,"value":90},");\n",{"type":23,"tag":35,"props":92,"children":97},{"className":93,"code":94,"filename":95,"language":96,"meta":41,"style":41},"language-rs shiki shiki-themes github-light-default github-dark-default","pub fn cmd_end_debug_utils_label_ext(\n    command_buffer: vk::CommandBuffer,\n);\n","Rust","rs",[98],{"type":23,"tag":44,"props":99,"children":100},{"__ignoreMap":41},[101,123,156],{"type":23,"tag":48,"props":102,"children":103},{"class":50,"line":51},[104,109,114,119],{"type":23,"tag":48,"props":105,"children":106},{"style":55},[107],{"type":28,"value":108},"pub",{"type":23,"tag":48,"props":110,"children":111},{"style":55},[112],{"type":28,"value":113}," fn",{"type":23,"tag":48,"props":115,"children":116},{"style":61},[117],{"type":28,"value":118}," cmd_end_debug_utils_label_ext",{"type":23,"tag":48,"props":120,"children":121},{"style":67},[122],{"type":28,"value":70},{"type":23,"tag":48,"props":124,"children":125},{"class":50,"line":73},[126,131,136,141,146,151],{"type":23,"tag":48,"props":127,"children":128},{"style":67},[129],{"type":28,"value":130},"    command_buffer",{"type":23,"tag":48,"props":132,"children":133},{"style":55},[134],{"type":28,"value":135},":",{"type":23,"tag":48,"props":137,"children":138},{"style":82},[139],{"type":28,"value":140}," vk",{"type":23,"tag":48,"props":142,"children":143},{"style":55},[144],{"type":28,"value":145},"::",{"type":23,"tag":48,"props":147,"children":148},{"style":82},[149],{"type":28,"value":150},"CommandBuffer",{"type":23,"tag":48,"props":152,"children":153},{"style":67},[154],{"type":28,"value":155},",\n",{"type":23,"tag":48,"props":157,"children":159},{"class":50,"line":158},3,[160],{"type":23,"tag":48,"props":161,"children":162},{"style":67},[163],{"type":28,"value":90},{"type":23,"tag":165,"props":166,"children":167},"ul",{},[168],{"type":23,"tag":169,"props":170,"children":171},"li",{},[172,177],{"type":23,"tag":44,"props":173,"children":175},{"className":174},[],[176],{"type":28,"value":85},{"type":28,"value":178}," is the command buffer into which the command is\nrecorded.",{"type":23,"tag":24,"props":180,"children":181},{},[182,184,189,191,198,200,205,207,211],{"type":28,"value":183},"An application ",{"type":23,"tag":185,"props":186,"children":188},"normative",{"type":187},"may",[],{"type":28,"value":190}," open a debug label region in one command buffer and\nclose it in another, or otherwise split debug label regions across multiple\ncommand buffers or multiple queue submissions.\nWhen viewed from the linear series of submissions to a single queue, the\ncalls to ",{"type":23,"tag":192,"props":193,"children":195},"a",{"href":194},"/man/vkCmdBeginDebugUtilsLabelEXT",[196],{"type":28,"value":197},"vkCmdBeginDebugUtilsLabelEXT",{"type":28,"value":199}," and\n",{"type":23,"tag":192,"props":201,"children":203},{"href":202},"/man/vkCmdEndDebugUtilsLabelEXT",[204],{"type":28,"value":4},{"type":28,"value":206}," ",{"type":23,"tag":185,"props":208,"children":210},{"type":209},"must",[],{"type":28,"value":212}," be matched and balanced.",{"type":23,"tag":24,"props":214,"children":215},{},[216,218,222,224,227,229,232,234,237,239,242],{"type":28,"value":217},"There ",{"type":23,"tag":185,"props":219,"children":221},{"type":220},"can",[],{"type":28,"value":223}," be problems reporting command buffer debug labels during the\nrecording process because command buffers ",{"type":23,"tag":185,"props":225,"children":226},{"type":187},[],{"type":28,"value":228}," be recorded out of sequence\nwith the resulting execution order.\nSince the recording order ",{"type":23,"tag":185,"props":230,"children":231},{"type":187},[],{"type":28,"value":233}," be different, a solitary command buffer ",{"type":23,"tag":185,"props":235,"children":236},{"type":187},[],{"type":28,"value":238},"\nhave an inconsistent view of the debug label regions by itself.\nTherefore, if an issue occurs during the recording of a command buffer, and\nthe environment requires returning debug labels, the implementation ",{"type":23,"tag":185,"props":240,"children":241},{"type":187},[],{"type":28,"value":243},"\nreturn only those labels it is aware of.\nThis is true even if the implementation is aware of only the debug labels\nwithin the command buffer being actively recorded.",{"type":23,"tag":245,"props":246,"children":248},"validity-group",{"name":247},"Valid Usage",[249,284],{"type":23,"tag":250,"props":251,"children":253},"validity-field",{"name":252},"VUID-vkCmdEndDebugUtilsLabelEXT-commandBuffer-01912",[254],{"type":23,"tag":24,"props":255,"children":256},{},[257,258,261,263,268,270,275,277,282],{"type":28,"value":217},{"type":23,"tag":185,"props":259,"children":260},{"type":209},[],{"type":28,"value":262}," be an outstanding ",{"type":23,"tag":44,"props":264,"children":266},{"className":265},[],[267],{"type":28,"value":197},{"type":28,"value":269}," command\nprior to the ",{"type":23,"tag":44,"props":271,"children":273},{"className":272},[],[274],{"type":28,"value":4},{"type":28,"value":276}," on the queue that\n",{"type":23,"tag":44,"props":278,"children":280},{"className":279},[],[281],{"type":28,"value":85},{"type":28,"value":283}," is submitted to",{"type":23,"tag":250,"props":285,"children":287},{"name":286},"VUID-vkCmdEndDebugUtilsLabelEXT-commandBuffer-01913",[288],{"type":23,"tag":24,"props":289,"children":290},{},[291,293,298,300,303,305,310,312,317,319],{"type":28,"value":292},"If ",{"type":23,"tag":44,"props":294,"children":296},{"className":295},[],[297],{"type":28,"value":85},{"type":28,"value":299}," is a secondary command buffer, there ",{"type":23,"tag":185,"props":301,"children":302},{"type":209},[],{"type":28,"value":304}," be an\noutstanding ",{"type":23,"tag":44,"props":306,"children":308},{"className":307},[],[309],{"type":28,"value":197},{"type":28,"value":311}," command recorded to\n",{"type":23,"tag":44,"props":313,"children":315},{"className":314},[],[316],{"type":28,"value":85},{"type":28,"value":318}," that has not previously been ended by a call to\n",{"type":23,"tag":44,"props":320,"children":322},{"className":321},[],[323],{"type":28,"value":4},{"type":23,"tag":245,"props":325,"children":327},{"name":326},"Valid Usage (Implicit)",[328,354,378,407],{"type":23,"tag":250,"props":329,"children":331},{"name":330},"VUID-vkCmdEndDebugUtilsLabelEXT-commandBuffer-parameter",[332],{"type":23,"tag":24,"props":333,"children":334},{},[335,340,341,344,346,352],{"type":23,"tag":44,"props":336,"children":338},{"className":337},[],[339],{"type":28,"value":85},{"type":28,"value":206},{"type":23,"tag":185,"props":342,"children":343},{"type":209},[],{"type":28,"value":345}," be a valid ",{"type":23,"tag":192,"props":347,"children":349},{"href":348},"/man/VkCommandBuffer",[350],{"type":28,"value":351},"VkCommandBuffer",{"type":28,"value":353}," handle",{"type":23,"tag":250,"props":355,"children":357},{"name":356},"VUID-vkCmdEndDebugUtilsLabelEXT-commandBuffer-recording",[358],{"type":23,"tag":24,"props":359,"children":360},{},[361,366,367,370,372],{"type":23,"tag":44,"props":362,"children":364},{"className":363},[],[365],{"type":28,"value":85},{"type":28,"value":206},{"type":23,"tag":185,"props":368,"children":369},{"type":209},[],{"type":28,"value":371}," be in the ",{"type":23,"tag":192,"props":373,"children":375},{"href":374},"/chapters/commandbuffers#commandbuffers-lifecycle",[376],{"type":28,"value":377},"recording state",{"type":23,"tag":250,"props":379,"children":381},{"name":380},"VUID-vkCmdEndDebugUtilsLabelEXT-commandBuffer-cmdpool",[382],{"type":23,"tag":24,"props":383,"children":384},{},[385,387,393,395,400,402,405],{"type":28,"value":386},"The ",{"type":23,"tag":44,"props":388,"children":390},{"className":389},[],[391],{"type":28,"value":392},"VkCommandPool",{"type":28,"value":394}," that ",{"type":23,"tag":44,"props":396,"children":398},{"className":397},[],[399],{"type":28,"value":85},{"type":28,"value":401}," was allocated from ",{"type":23,"tag":185,"props":403,"children":404},{"type":209},[],{"type":28,"value":406}," support graphics, or compute operations",{"type":23,"tag":250,"props":408,"children":410},{"name":409},"VUID-vkCmdEndDebugUtilsLabelEXT-videocoding",[411],{"type":23,"tag":24,"props":412,"children":413},{},[414,416,419],{"type":28,"value":415},"This command ",{"type":23,"tag":185,"props":417,"children":418},{"type":209},[],{"type":28,"value":420}," only be called outside of a video coding scope",{"type":23,"tag":422,"props":423,"children":425},"validity-box",{"name":424},"Host Synchronization",[426],{"type":23,"tag":165,"props":427,"children":428},{},[429,445],{"type":23,"tag":169,"props":430,"children":431},{},[432,434,439,440,443],{"type":28,"value":433},"Host access to ",{"type":23,"tag":44,"props":435,"children":437},{"className":436},[],[438],{"type":28,"value":85},{"type":28,"value":206},{"type":23,"tag":185,"props":441,"children":442},{"type":209},[],{"type":28,"value":444}," be externally synchronized",{"type":23,"tag":169,"props":446,"children":447},{},[448,450,455,456,461,462,465],{"type":28,"value":449},"Host access to the ",{"type":23,"tag":44,"props":451,"children":453},{"className":452},[],[454],{"type":28,"value":392},{"type":28,"value":394},{"type":23,"tag":44,"props":457,"children":459},{"className":458},[],[460],{"type":28,"value":85},{"type":28,"value":401},{"type":23,"tag":185,"props":463,"children":464},{"type":209},[],{"type":28,"value":466}," be externally synchronized\n::",{"type":23,"tag":468,"props":469,"children":470},"style",{},[471],{"type":28,"value":472},"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":41,"searchDepth":73,"depth":73,"links":474},[],"markdown",1725732605067]