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