[{"data":1,"prerenderedAt":624},["ShallowReactive",2],{"UHQ7aIiIxj":3},{"title":4,"description":5,"parent":6,"type":7,"xrefs":8,"body":9,"_type":623,"_id":4},"vkBeginCommandBuffer","Start recording a command buffer","VK_VERSION_1_0","protos",[],{"type":10,"children":11,"toc":621},"root",[12,20,239,274,514,567,615],{"type":13,"tag":14,"props":15,"children":16},"element","p",{},[17],{"type":18,"value":19},"text","To begin recording a command buffer, call:",{"type":13,"tag":21,"props":22,"children":23},"code-group",{},[24,109],{"type":13,"tag":25,"props":26,"children":32},"pre",{"className":27,"code":28,"filename":29,"language":30,"meta":31,"style":31},"language-c shiki shiki-themes github-light-default github-dark-default","VkResult vkBeginCommandBuffer(\n    VkCommandBuffer commandBuffer,\n    const VkCommandBufferBeginInfo* pBeginInfo);\n","C","c","",[33],{"type":13,"tag":34,"props":35,"children":36},"code",{"__ignoreMap":31},[37,59,79],{"type":13,"tag":38,"props":39,"children":42},"span",{"class":40,"line":41},"line",1,[43,49,54],{"type":13,"tag":38,"props":44,"children":46},{"style":45},"--shiki-default:#1F2328;--shiki-dark:#E6EDF3",[47],{"type":18,"value":48},"VkResult ",{"type":13,"tag":38,"props":50,"children":52},{"style":51},"--shiki-default:#8250DF;--shiki-dark:#D2A8FF",[53],{"type":18,"value":4},{"type":13,"tag":38,"props":55,"children":56},{"style":45},[57],{"type":18,"value":58},"(\n",{"type":13,"tag":38,"props":60,"children":62},{"class":40,"line":61},2,[63,68,74],{"type":13,"tag":38,"props":64,"children":65},{"style":45},[66],{"type":18,"value":67},"    VkCommandBuffer ",{"type":13,"tag":38,"props":69,"children":71},{"style":70},"--shiki-default:#953800;--shiki-dark:#FFA657",[72],{"type":18,"value":73},"commandBuffer",{"type":13,"tag":38,"props":75,"children":76},{"style":45},[77],{"type":18,"value":78},",\n",{"type":13,"tag":38,"props":80,"children":82},{"class":40,"line":81},3,[83,89,94,99,104],{"type":13,"tag":38,"props":84,"children":86},{"style":85},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[87],{"type":18,"value":88},"    const",{"type":13,"tag":38,"props":90,"children":91},{"style":45},[92],{"type":18,"value":93}," VkCommandBufferBeginInfo",{"type":13,"tag":38,"props":95,"children":96},{"style":85},[97],{"type":18,"value":98},"*",{"type":13,"tag":38,"props":100,"children":101},{"style":70},[102],{"type":18,"value":103}," pBeginInfo",{"type":13,"tag":38,"props":105,"children":106},{"style":45},[107],{"type":18,"value":108},");\n",{"type":13,"tag":25,"props":110,"children":115},{"className":111,"code":112,"filename":113,"language":114,"meta":31,"style":31},"language-rs shiki shiki-themes github-light-default github-dark-default","pub fn begin_command_buffer(\n    command_buffer: vk::CommandBuffer,\n    p_begin_info: *const vk::CommandBufferBeginInfo,\n) -> vk::Result;\n","Rust","rs",[116],{"type":13,"tag":34,"props":117,"children":118},{"__ignoreMap":31},[119,141,173,207],{"type":13,"tag":38,"props":120,"children":121},{"class":40,"line":41},[122,127,132,137],{"type":13,"tag":38,"props":123,"children":124},{"style":85},[125],{"type":18,"value":126},"pub",{"type":13,"tag":38,"props":128,"children":129},{"style":85},[130],{"type":18,"value":131}," fn",{"type":13,"tag":38,"props":133,"children":134},{"style":51},[135],{"type":18,"value":136}," begin_command_buffer",{"type":13,"tag":38,"props":138,"children":139},{"style":45},[140],{"type":18,"value":58},{"type":13,"tag":38,"props":142,"children":143},{"class":40,"line":61},[144,149,154,159,164,169],{"type":13,"tag":38,"props":145,"children":146},{"style":45},[147],{"type":18,"value":148},"    command_buffer",{"type":13,"tag":38,"props":150,"children":151},{"style":85},[152],{"type":18,"value":153},":",{"type":13,"tag":38,"props":155,"children":156},{"style":70},[157],{"type":18,"value":158}," vk",{"type":13,"tag":38,"props":160,"children":161},{"style":85},[162],{"type":18,"value":163},"::",{"type":13,"tag":38,"props":165,"children":166},{"style":70},[167],{"type":18,"value":168},"CommandBuffer",{"type":13,"tag":38,"props":170,"children":171},{"style":45},[172],{"type":18,"value":78},{"type":13,"tag":38,"props":174,"children":175},{"class":40,"line":81},[176,181,185,190,194,198,203],{"type":13,"tag":38,"props":177,"children":178},{"style":45},[179],{"type":18,"value":180},"    p_begin_info",{"type":13,"tag":38,"props":182,"children":183},{"style":85},[184],{"type":18,"value":153},{"type":13,"tag":38,"props":186,"children":187},{"style":85},[188],{"type":18,"value":189}," *const",{"type":13,"tag":38,"props":191,"children":192},{"style":70},[193],{"type":18,"value":158},{"type":13,"tag":38,"props":195,"children":196},{"style":85},[197],{"type":18,"value":163},{"type":13,"tag":38,"props":199,"children":200},{"style":70},[201],{"type":18,"value":202},"CommandBufferBeginInfo",{"type":13,"tag":38,"props":204,"children":205},{"style":45},[206],{"type":18,"value":78},{"type":13,"tag":38,"props":208,"children":210},{"class":40,"line":209},4,[211,216,221,225,229,234],{"type":13,"tag":38,"props":212,"children":213},{"style":45},[214],{"type":18,"value":215},") ",{"type":13,"tag":38,"props":217,"children":218},{"style":85},[219],{"type":18,"value":220},"->",{"type":13,"tag":38,"props":222,"children":223},{"style":70},[224],{"type":18,"value":158},{"type":13,"tag":38,"props":226,"children":227},{"style":85},[228],{"type":18,"value":163},{"type":13,"tag":38,"props":230,"children":231},{"style":70},[232],{"type":18,"value":233},"Result",{"type":13,"tag":38,"props":235,"children":236},{"style":45},[237],{"type":18,"value":238},";\n",{"type":13,"tag":240,"props":241,"children":242},"ul",{},[243,254],{"type":13,"tag":244,"props":245,"children":246},"li",{},[247,252],{"type":13,"tag":34,"props":248,"children":250},{"className":249},[],[251],{"type":18,"value":73},{"type":18,"value":253}," is the handle of the command buffer which is to be\nput in the recording state.",{"type":13,"tag":244,"props":255,"children":256},{},[257,263,265,272],{"type":13,"tag":34,"props":258,"children":260},{"className":259},[],[261],{"type":18,"value":262},"pBeginInfo",{"type":18,"value":264}," is a pointer to a ",{"type":13,"tag":266,"props":267,"children":269},"a",{"href":268},"/man/VkCommandBufferBeginInfo",[270],{"type":18,"value":271},"VkCommandBufferBeginInfo",{"type":18,"value":273},"\nstructure defining additional information about how the command buffer\nbegins recording.",{"type":13,"tag":275,"props":276,"children":278},"validity-group",{"name":277},"Valid Usage",[279,307,355,397,471],{"type":13,"tag":280,"props":281,"children":283},"validity-field",{"name":282},"VUID-vkBeginCommandBuffer-commandBuffer-00049",[284],{"type":13,"tag":14,"props":285,"children":286},{},[287,292,294,299,301],{"type":13,"tag":34,"props":288,"children":290},{"className":289},[],[291],{"type":18,"value":73},{"type":18,"value":293}," ",{"type":13,"tag":295,"props":296,"children":298},"normative",{"type":297},"must",[],{"type":18,"value":300}," not be in the ",{"type":13,"tag":266,"props":302,"children":304},{"href":303},"/chapters/commandbuffers#commandbuffers-lifecycle",[305],{"type":18,"value":306},"recording or pending state",{"type":13,"tag":280,"props":308,"children":310},{"name":309},"VUID-vkBeginCommandBuffer-commandBuffer-00050",[311],{"type":13,"tag":14,"props":312,"children":313},{},[314,316,321,323,329,331,337,339,344,345,348,350],{"type":18,"value":315},"If ",{"type":13,"tag":34,"props":317,"children":319},{"className":318},[],[320],{"type":18,"value":73},{"type":18,"value":322}," was allocated from a ",{"type":13,"tag":266,"props":324,"children":326},{"href":325},"/man/VkCommandPool",[327],{"type":18,"value":328},"VkCommandPool",{"type":18,"value":330}," which\ndid not have the ",{"type":13,"tag":34,"props":332,"children":334},{"className":333},[],[335],{"type":18,"value":336},"VK_COMMAND_POOL_CREATE_RESET_COMMAND_BUFFER_BIT",{"type":18,"value":338},"\nflag set, ",{"type":13,"tag":34,"props":340,"children":342},{"className":341},[],[343],{"type":18,"value":73},{"type":18,"value":293},{"type":13,"tag":295,"props":346,"children":347},{"type":297},[],{"type":18,"value":349}," be in the\n",{"type":13,"tag":266,"props":351,"children":352},{"href":303},[353],{"type":18,"value":354},"initial state",{"type":13,"tag":280,"props":356,"children":358},{"name":357},"VUID-vkBeginCommandBuffer-commandBuffer-00051",[359],{"type":13,"tag":14,"props":360,"children":361},{},[362,363,368,370,376,378,383,384,387,389,395],{"type":18,"value":315},{"type":13,"tag":34,"props":364,"children":366},{"className":365},[],[367],{"type":18,"value":73},{"type":18,"value":369}," is a secondary command buffer, the\n",{"type":13,"tag":34,"props":371,"children":373},{"className":372},[],[374],{"type":18,"value":375},"pInheritanceInfo",{"type":18,"value":377}," member of ",{"type":13,"tag":34,"props":379,"children":381},{"className":380},[],[382],{"type":18,"value":262},{"type":18,"value":293},{"type":13,"tag":295,"props":385,"children":386},{"type":297},[],{"type":18,"value":388}," be a valid\n",{"type":13,"tag":34,"props":390,"children":392},{"className":391},[],[393],{"type":18,"value":394},"VkCommandBufferInheritanceInfo",{"type":18,"value":396}," structure",{"type":13,"tag":280,"props":398,"children":400},{"name":399},"VUID-vkBeginCommandBuffer-commandBuffer-00052",[401],{"type":13,"tag":14,"props":402,"children":403},{},[404,405,410,412,418,420,425,427,432,434,440,442,452,454,460,463,465],{"type":18,"value":315},{"type":13,"tag":34,"props":406,"children":408},{"className":407},[],[409],{"type":18,"value":73},{"type":18,"value":411}," is a secondary command buffer and either the\n",{"type":13,"tag":34,"props":413,"children":415},{"className":414},[],[416],{"type":18,"value":417},"occlusionQueryEnable",{"type":18,"value":419}," member of the ",{"type":13,"tag":34,"props":421,"children":423},{"className":422},[],[424],{"type":18,"value":375},{"type":18,"value":426}," member\nof ",{"type":13,"tag":34,"props":428,"children":430},{"className":429},[],[431],{"type":18,"value":262},{"type":18,"value":433}," is ",{"type":13,"tag":34,"props":435,"children":437},{"className":436},[],[438],{"type":18,"value":439},"VK_FALSE",{"type":18,"value":441},", or the\n",{"type":13,"tag":266,"props":443,"children":445},{"href":444},"/man/VkPhysicalDeviceFeatures#features-occlusionQueryPrecise",[446],{"type":13,"tag":34,"props":447,"children":449},{"className":448},[],[450],{"type":18,"value":451},"occlusionQueryPrecise",{"type":18,"value":453}," feature\nis not enabled, then ",{"type":13,"tag":34,"props":455,"children":457},{"className":456},[],[458],{"type":18,"value":459},"pBeginInfo→pInheritanceInfo→queryFlags",{"type":13,"tag":295,"props":461,"children":462},{"type":297},[],{"type":18,"value":464}," not contain ",{"type":13,"tag":34,"props":466,"children":468},{"className":467},[],[469],{"type":18,"value":470},"VK_QUERY_CONTROL_PRECISE_BIT",{"type":13,"tag":280,"props":472,"children":474},{"name":473},"VUID-vkBeginCommandBuffer-commandBuffer-02840",[475],{"type":13,"tag":14,"props":476,"children":477},{},[478,479,484,486,492,493,496,498,504,506,512],{"type":18,"value":315},{"type":13,"tag":34,"props":480,"children":482},{"className":481},[],[483],{"type":18,"value":73},{"type":18,"value":485}," is a primary command buffer, then\n",{"type":13,"tag":34,"props":487,"children":489},{"className":488},[],[490],{"type":18,"value":491},"pBeginInfo→flags",{"type":18,"value":293},{"type":13,"tag":295,"props":494,"children":495},{"type":297},[],{"type":18,"value":497}," not set both the\n",{"type":13,"tag":34,"props":499,"children":501},{"className":500},[],[502],{"type":18,"value":503},"VK_COMMAND_BUFFER_USAGE_ONE_TIME_SUBMIT_BIT",{"type":18,"value":505}," and the\n",{"type":13,"tag":34,"props":507,"children":509},{"className":508},[],[510],{"type":18,"value":511},"VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT",{"type":18,"value":513}," flags",{"type":13,"tag":275,"props":515,"children":517},{"name":516},"Valid Usage (Implicit)",[518,544],{"type":13,"tag":280,"props":519,"children":521},{"name":520},"VUID-vkBeginCommandBuffer-commandBuffer-parameter",[522],{"type":13,"tag":14,"props":523,"children":524},{},[525,530,531,534,536,542],{"type":13,"tag":34,"props":526,"children":528},{"className":527},[],[529],{"type":18,"value":73},{"type":18,"value":293},{"type":13,"tag":295,"props":532,"children":533},{"type":297},[],{"type":18,"value":535}," be a valid ",{"type":13,"tag":266,"props":537,"children":539},{"href":538},"/man/VkCommandBuffer",[540],{"type":18,"value":541},"VkCommandBuffer",{"type":18,"value":543}," handle",{"type":13,"tag":280,"props":545,"children":547},{"name":546},"VUID-vkBeginCommandBuffer-pBeginInfo-parameter",[548],{"type":13,"tag":14,"props":549,"children":550},{},[551,556,557,560,562,566],{"type":13,"tag":34,"props":552,"children":554},{"className":553},[],[555],{"type":18,"value":262},{"type":18,"value":293},{"type":13,"tag":295,"props":558,"children":559},{"type":297},[],{"type":18,"value":561}," be a valid pointer to a valid ",{"type":13,"tag":266,"props":563,"children":564},{"href":268},[565],{"type":18,"value":271},{"type":18,"value":396},{"type":13,"tag":568,"props":569,"children":571},"validity-box",{"name":570},"Host Synchronization",[572],{"type":13,"tag":240,"props":573,"children":574},{},[575,591],{"type":13,"tag":244,"props":576,"children":577},{},[578,580,585,586,589],{"type":18,"value":579},"Host access to ",{"type":13,"tag":34,"props":581,"children":583},{"className":582},[],[584],{"type":18,"value":73},{"type":18,"value":293},{"type":13,"tag":295,"props":587,"children":588},{"type":297},[],{"type":18,"value":590}," be externally synchronized",{"type":13,"tag":244,"props":592,"children":593},{},[594,596,601,603,608,610,613],{"type":18,"value":595},"Host access to the ",{"type":13,"tag":34,"props":597,"children":599},{"className":598},[],[600],{"type":18,"value":328},{"type":18,"value":602}," that ",{"type":13,"tag":34,"props":604,"children":606},{"className":605},[],[607],{"type":18,"value":73},{"type":18,"value":609}," was allocated from ",{"type":13,"tag":295,"props":611,"children":612},{"type":297},[],{"type":18,"value":614}," be externally synchronized\n::",{"type":13,"tag":616,"props":617,"children":618},"style",{},[619],{"type":18,"value":620},"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":31,"searchDepth":61,"depth":61,"links":622},[],"markdown",1725732596845]