[{"data":1,"prerenderedAt":693},["ShallowReactive",2],{"$f72EpDq8bX-psWTXo4XAVMAAqbh_M8fiXn5Lo9SQqpz4":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":692,"_id":4},"vkCmdBeginGpaSampleAMD","Beginning a sample","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":690},"root",[29,37,347,403,639,684],{"type":30,"tag":31,"props":32,"children":33},"element","p",{},[34],{"type":35,"value":36},"text","To begin a GPA sample, call:",{"type":30,"tag":38,"props":39,"children":40},"code-group",{},[41,162],{"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 vkCmdBeginGpaSampleAMD(\n    VkCommandBuffer commandBuffer,\n    VkGpaSessionAMD                   gpaSession,\n    const VkGpaSampleBeginInfoAMD*    pGpaSampleBeginInfo,\n    uint32_t*                         pSampleID);\n","C","c","",[50],{"type":30,"tag":51,"props":52,"children":53},"code",{"__ignoreMap":48},[54,76,96,114,143],{"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":95},{"type":30,"tag":55,"props":115,"children":117},{"class":57,"line":116},4,[118,124,129,134,139],{"type":30,"tag":55,"props":119,"children":121},{"style":120},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[122],{"type":35,"value":123},"    const",{"type":30,"tag":55,"props":125,"children":126},{"style":62},[127],{"type":35,"value":128}," VkGpaSampleBeginInfoAMD",{"type":30,"tag":55,"props":130,"children":131},{"style":120},[132],{"type":35,"value":133},"*",{"type":30,"tag":55,"props":135,"children":136},{"style":87},[137],{"type":35,"value":138},"    pGpaSampleBeginInfo",{"type":30,"tag":55,"props":140,"children":141},{"style":62},[142],{"type":35,"value":95},{"type":30,"tag":55,"props":144,"children":146},{"class":57,"line":145},5,[147,152,157],{"type":30,"tag":55,"props":148,"children":149},{"style":120},[150],{"type":35,"value":151},"    uint32_t*",{"type":30,"tag":55,"props":153,"children":154},{"style":87},[155],{"type":35,"value":156},"                         pSampleID",{"type":30,"tag":55,"props":158,"children":159},{"style":62},[160],{"type":35,"value":161},");\n",{"type":30,"tag":42,"props":163,"children":168},{"className":164,"code":165,"filename":166,"language":167,"meta":48,"style":48},"language-rs shiki shiki-themes github-light-default github-dark-default","pub fn cmd_begin_gpa_sample_amd(\n    command_buffer: vk::CommandBuffer,\n    gpa_session: vk::GpaSessionAMD,\n    p_gpa_sample_begin_info: *const vk::GpaSampleBeginInfoAMD,\n    p_sample_id: *mut u32,\n) -> vk::Result;\n","Rust","rs",[169],{"type":30,"tag":51,"props":170,"children":171},{"__ignoreMap":48},[172,194,226,255,289,315],{"type":30,"tag":55,"props":173,"children":174},{"class":57,"line":58},[175,180,185,190],{"type":30,"tag":55,"props":176,"children":177},{"style":120},[178],{"type":35,"value":179},"pub",{"type":30,"tag":55,"props":181,"children":182},{"style":120},[183],{"type":35,"value":184}," fn",{"type":30,"tag":55,"props":186,"children":187},{"style":68},[188],{"type":35,"value":189}," cmd_begin_gpa_sample_amd",{"type":30,"tag":55,"props":191,"children":192},{"style":62},[193],{"type":35,"value":75},{"type":30,"tag":55,"props":195,"children":196},{"class":57,"line":78},[197,202,207,212,217,222],{"type":30,"tag":55,"props":198,"children":199},{"style":62},[200],{"type":35,"value":201},"    command_buffer",{"type":30,"tag":55,"props":203,"children":204},{"style":120},[205],{"type":35,"value":206},":",{"type":30,"tag":55,"props":208,"children":209},{"style":87},[210],{"type":35,"value":211}," vk",{"type":30,"tag":55,"props":213,"children":214},{"style":120},[215],{"type":35,"value":216},"::",{"type":30,"tag":55,"props":218,"children":219},{"style":87},[220],{"type":35,"value":221},"CommandBuffer",{"type":30,"tag":55,"props":223,"children":224},{"style":62},[225],{"type":35,"value":95},{"type":30,"tag":55,"props":227,"children":228},{"class":57,"line":98},[229,234,238,242,246,251],{"type":30,"tag":55,"props":230,"children":231},{"style":62},[232],{"type":35,"value":233},"    gpa_session",{"type":30,"tag":55,"props":235,"children":236},{"style":120},[237],{"type":35,"value":206},{"type":30,"tag":55,"props":239,"children":240},{"style":87},[241],{"type":35,"value":211},{"type":30,"tag":55,"props":243,"children":244},{"style":120},[245],{"type":35,"value":216},{"type":30,"tag":55,"props":247,"children":248},{"style":87},[249],{"type":35,"value":250},"GpaSessionAMD",{"type":30,"tag":55,"props":252,"children":253},{"style":62},[254],{"type":35,"value":95},{"type":30,"tag":55,"props":256,"children":257},{"class":57,"line":116},[258,263,267,272,276,280,285],{"type":30,"tag":55,"props":259,"children":260},{"style":62},[261],{"type":35,"value":262},"    p_gpa_sample_begin_info",{"type":30,"tag":55,"props":264,"children":265},{"style":120},[266],{"type":35,"value":206},{"type":30,"tag":55,"props":268,"children":269},{"style":120},[270],{"type":35,"value":271}," *const",{"type":30,"tag":55,"props":273,"children":274},{"style":87},[275],{"type":35,"value":211},{"type":30,"tag":55,"props":277,"children":278},{"style":120},[279],{"type":35,"value":216},{"type":30,"tag":55,"props":281,"children":282},{"style":87},[283],{"type":35,"value":284},"GpaSampleBeginInfoAMD",{"type":30,"tag":55,"props":286,"children":287},{"style":62},[288],{"type":35,"value":95},{"type":30,"tag":55,"props":290,"children":291},{"class":57,"line":145},[292,297,301,306,311],{"type":30,"tag":55,"props":293,"children":294},{"style":62},[295],{"type":35,"value":296},"    p_sample_id",{"type":30,"tag":55,"props":298,"children":299},{"style":120},[300],{"type":35,"value":206},{"type":30,"tag":55,"props":302,"children":303},{"style":120},[304],{"type":35,"value":305}," *mut",{"type":30,"tag":55,"props":307,"children":308},{"style":87},[309],{"type":35,"value":310}," u32",{"type":30,"tag":55,"props":312,"children":313},{"style":62},[314],{"type":35,"value":95},{"type":30,"tag":55,"props":316,"children":318},{"class":57,"line":317},6,[319,324,329,333,337,342],{"type":30,"tag":55,"props":320,"children":321},{"style":62},[322],{"type":35,"value":323},") ",{"type":30,"tag":55,"props":325,"children":326},{"style":120},[327],{"type":35,"value":328},"->",{"type":30,"tag":55,"props":330,"children":331},{"style":87},[332],{"type":35,"value":211},{"type":30,"tag":55,"props":334,"children":335},{"style":120},[336],{"type":35,"value":216},{"type":30,"tag":55,"props":338,"children":339},{"style":87},[340],{"type":35,"value":341},"Result",{"type":30,"tag":55,"props":343,"children":344},{"style":62},[345],{"type":35,"value":346},";\n",{"type":30,"tag":348,"props":349,"children":350},"ul",{},[351,362,372,392],{"type":30,"tag":352,"props":353,"children":354},"li",{},[355,360],{"type":30,"tag":51,"props":356,"children":358},{"className":357},[],[359],{"type":35,"value":90},{"type":35,"value":361}," is the command buffer into which the command will be\nrecorded.",{"type":30,"tag":352,"props":363,"children":364},{},[365,370],{"type":30,"tag":51,"props":366,"children":368},{"className":367},[],[369],{"type":35,"value":109},{"type":35,"value":371}," is the handle of the GPA session to record the sample.",{"type":30,"tag":352,"props":373,"children":374},{},[375,381,383,390],{"type":30,"tag":51,"props":376,"children":378},{"className":377},[],[379],{"type":35,"value":380},"pGpaSampleBeginInfo",{"type":35,"value":382}," is a pointer to a\n",{"type":30,"tag":384,"props":385,"children":387},"a",{"href":386},"/man/VkGpaSampleBeginInfoAMD",[388],{"type":35,"value":389},"VkGpaSampleBeginInfoAMD",{"type":35,"value":391}," structure describing the sample\nparameters.",{"type":30,"tag":352,"props":393,"children":394},{},[395,401],{"type":30,"tag":51,"props":396,"children":398},{"className":397},[],[399],{"type":35,"value":400},"pSampleID",{"type":35,"value":402}," is the unique sample ID returned for this sample.",{"type":30,"tag":404,"props":405,"children":407},"validity-group",{"name":406},"Valid Usage (Implicit)",[408,438,462,486,512,536,579,593,606],{"type":30,"tag":409,"props":410,"children":412},"validity-field",{"name":411},"VUID-vkCmdBeginGpaSampleAMD-commandBuffer-parameter",[413],{"type":30,"tag":31,"props":414,"children":415},{},[416,421,423,428,430,436],{"type":30,"tag":51,"props":417,"children":419},{"className":418},[],[420],{"type":35,"value":90},{"type":35,"value":422}," ",{"type":30,"tag":424,"props":425,"children":427},"normative",{"type":426},"must",[],{"type":35,"value":429}," be a valid ",{"type":30,"tag":384,"props":431,"children":433},{"href":432},"/man/VkCommandBuffer",[434],{"type":35,"value":435},"VkCommandBuffer",{"type":35,"value":437}," handle",{"type":30,"tag":409,"props":439,"children":441},{"name":440},"VUID-vkCmdBeginGpaSampleAMD-gpaSession-parameter",[442],{"type":30,"tag":31,"props":443,"children":444},{},[445,450,451,454,455,461],{"type":30,"tag":51,"props":446,"children":448},{"className":447},[],[449],{"type":35,"value":109},{"type":35,"value":422},{"type":30,"tag":424,"props":452,"children":453},{"type":426},[],{"type":35,"value":429},{"type":30,"tag":384,"props":456,"children":458},{"href":457},"/man/VkGpaSessionAMD",[459],{"type":35,"value":460},"VkGpaSessionAMD",{"type":35,"value":437},{"type":30,"tag":409,"props":463,"children":465},{"name":464},"VUID-vkCmdBeginGpaSampleAMD-pGpaSampleBeginInfo-parameter",[466],{"type":30,"tag":31,"props":467,"children":468},{},[469,474,475,478,480,484],{"type":30,"tag":51,"props":470,"children":472},{"className":471},[],[473],{"type":35,"value":380},{"type":35,"value":422},{"type":30,"tag":424,"props":476,"children":477},{"type":426},[],{"type":35,"value":479}," be a valid pointer to a valid ",{"type":30,"tag":384,"props":481,"children":482},{"href":386},[483],{"type":35,"value":389},{"type":35,"value":485}," structure",{"type":30,"tag":409,"props":487,"children":489},{"name":488},"VUID-vkCmdBeginGpaSampleAMD-pSampleID-parameter",[490],{"type":30,"tag":31,"props":491,"children":492},{},[493,498,499,502,504,510],{"type":30,"tag":51,"props":494,"children":496},{"className":495},[],[497],{"type":35,"value":400},{"type":35,"value":422},{"type":30,"tag":424,"props":500,"children":501},{"type":426},[],{"type":35,"value":503}," be a valid pointer to a ",{"type":30,"tag":51,"props":505,"children":507},{"className":506},[],[508],{"type":35,"value":509},"uint32_t",{"type":35,"value":511}," value",{"type":30,"tag":409,"props":513,"children":515},{"name":514},"VUID-vkCmdBeginGpaSampleAMD-commandBuffer-recording",[516],{"type":30,"tag":31,"props":517,"children":518},{},[519,524,525,528,530],{"type":30,"tag":51,"props":520,"children":522},{"className":521},[],[523],{"type":35,"value":90},{"type":35,"value":422},{"type":30,"tag":424,"props":526,"children":527},{"type":426},[],{"type":35,"value":529}," be in the ",{"type":30,"tag":384,"props":531,"children":533},{"href":532},"/chapters/commandbuffers#commandbuffers-lifecycle",[534],{"type":35,"value":535},"recording state",{"type":30,"tag":409,"props":537,"children":539},{"name":538},"VUID-vkCmdBeginGpaSampleAMD-commandBuffer-cmdpool",[540],{"type":30,"tag":31,"props":541,"children":542},{},[543,545,551,553,558,560,563,565,570,572,577],{"type":35,"value":544},"The ",{"type":30,"tag":51,"props":546,"children":548},{"className":547},[],[549],{"type":35,"value":550},"VkCommandPool",{"type":35,"value":552}," that ",{"type":30,"tag":51,"props":554,"children":556},{"className":555},[],[557],{"type":35,"value":90},{"type":35,"value":559}," was allocated from ",{"type":30,"tag":424,"props":561,"children":562},{"type":426},[],{"type":35,"value":564}," support ",{"type":30,"tag":51,"props":566,"children":568},{"className":567},[],[569],{"type":35,"value":13},{"type":35,"value":571},", or ",{"type":30,"tag":51,"props":573,"children":575},{"className":574},[],[576],{"type":35,"value":12},{"type":35,"value":578}," operations",{"type":30,"tag":409,"props":580,"children":582},{"name":581},"VUID-vkCmdBeginGpaSampleAMD-suspended",[583],{"type":30,"tag":31,"props":584,"children":585},{},[586,588,591],{"type":35,"value":587},"This command ",{"type":30,"tag":424,"props":589,"children":590},{"type":426},[],{"type":35,"value":592}," not be called between suspended render pass instances",{"type":30,"tag":409,"props":594,"children":596},{"name":595},"VUID-vkCmdBeginGpaSampleAMD-videocoding",[597],{"type":30,"tag":31,"props":598,"children":599},{},[600,601,604],{"type":35,"value":587},{"type":30,"tag":424,"props":602,"children":603},{"type":426},[],{"type":35,"value":605}," only be called outside of a video coding scope",{"type":30,"tag":409,"props":607,"children":609},{"name":608},"VUID-vkCmdBeginGpaSampleAMD-commonparent",[610],{"type":30,"tag":31,"props":611,"children":612},{},[613,615,620,622,627,628,631,633],{"type":35,"value":614},"Both of ",{"type":30,"tag":51,"props":616,"children":618},{"className":617},[],[619],{"type":35,"value":90},{"type":35,"value":621},", and ",{"type":30,"tag":51,"props":623,"children":625},{"className":624},[],[626],{"type":35,"value":109},{"type":35,"value":422},{"type":30,"tag":424,"props":629,"children":630},{"type":426},[],{"type":35,"value":632}," have been created, allocated, or retrieved from the same ",{"type":30,"tag":384,"props":634,"children":636},{"href":635},"/man/VkDevice",[637],{"type":35,"value":638},"VkDevice",{"type":30,"tag":640,"props":641,"children":643},"validity-box",{"name":642},"Host Synchronization",[644],{"type":30,"tag":348,"props":645,"children":646},{},[647,663],{"type":30,"tag":352,"props":648,"children":649},{},[650,652,657,658,661],{"type":35,"value":651},"Host access to ",{"type":30,"tag":51,"props":653,"children":655},{"className":654},[],[656],{"type":35,"value":90},{"type":35,"value":422},{"type":30,"tag":424,"props":659,"children":660},{"type":426},[],{"type":35,"value":662}," be externally synchronized",{"type":30,"tag":352,"props":664,"children":665},{},[666,668,673,674,679,680,683],{"type":35,"value":667},"Host access to the ",{"type":30,"tag":51,"props":669,"children":671},{"className":670},[],[672],{"type":35,"value":550},{"type":35,"value":552},{"type":30,"tag":51,"props":675,"children":677},{"className":676},[],[678],{"type":35,"value":90},{"type":35,"value":559},{"type":30,"tag":424,"props":681,"children":682},{"type":426},[],{"type":35,"value":662},{"type":30,"tag":685,"props":686,"children":687},"style",{},[688],{"type":35,"value":689},"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":691},[],"markdown",1778234140441]