[{"data":1,"prerenderedAt":756},["ShallowReactive",2],{"ffdJSVhTRP":3},{"title":4,"description":5,"parent":6,"type":7,"xrefs":8,"body":9,"_type":755,"_id":4},"VkPresentIdKHR","The list of presentation identifiers","VK_KHR_present_id","structs",[],{"type":10,"children":11,"toc":753},"root",[12,28,290,406,459,479,544,555,649,747],{"type":13,"tag":14,"props":15,"children":16},"element","p",{},[17,20,26],{"type":18,"value":19},"text","The ",{"type":13,"tag":21,"props":22,"children":24},"code",{"className":23},[],[25],{"type":18,"value":4},{"type":18,"value":27}," structure is defined as:",{"type":13,"tag":29,"props":30,"children":31},"code-group",{},[32,136],{"type":13,"tag":33,"props":34,"children":40},"pre",{"className":35,"code":36,"filename":37,"language":38,"meta":39,"style":39},"language-c shiki shiki-themes github-light-default github-dark-default","typedef struct VkPresentIdKHR {\n    VkStructureType sType;\n    const void* pNext;\n    uint32_t swapchainCount;\n    const uint64_t* pPresentIds;\n} VkPresentIdKHR;\n","C","c","",[41],{"type":13,"tag":21,"props":42,"children":43},{"__ignoreMap":39},[44,67,76,95,109,127],{"type":13,"tag":45,"props":46,"children":49},"span",{"class":47,"line":48},"line",1,[50,56,61],{"type":13,"tag":45,"props":51,"children":53},{"style":52},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[54],{"type":18,"value":55},"typedef",{"type":13,"tag":45,"props":57,"children":58},{"style":52},[59],{"type":18,"value":60}," struct",{"type":13,"tag":45,"props":62,"children":64},{"style":63},"--shiki-default:#1F2328;--shiki-dark:#E6EDF3",[65],{"type":18,"value":66}," VkPresentIdKHR {\n",{"type":13,"tag":45,"props":68,"children":70},{"class":47,"line":69},2,[71],{"type":13,"tag":45,"props":72,"children":73},{"style":63},[74],{"type":18,"value":75},"    VkStructureType sType;\n",{"type":13,"tag":45,"props":77,"children":79},{"class":47,"line":78},3,[80,85,90],{"type":13,"tag":45,"props":81,"children":82},{"style":52},[83],{"type":18,"value":84},"    const",{"type":13,"tag":45,"props":86,"children":87},{"style":52},[88],{"type":18,"value":89}," void*",{"type":13,"tag":45,"props":91,"children":92},{"style":63},[93],{"type":18,"value":94}," pNext;\n",{"type":13,"tag":45,"props":96,"children":98},{"class":47,"line":97},4,[99,104],{"type":13,"tag":45,"props":100,"children":101},{"style":52},[102],{"type":18,"value":103},"    uint32_t",{"type":13,"tag":45,"props":105,"children":106},{"style":63},[107],{"type":18,"value":108}," swapchainCount;\n",{"type":13,"tag":45,"props":110,"children":112},{"class":47,"line":111},5,[113,117,122],{"type":13,"tag":45,"props":114,"children":115},{"style":52},[116],{"type":18,"value":84},{"type":13,"tag":45,"props":118,"children":119},{"style":52},[120],{"type":18,"value":121}," uint64_t*",{"type":13,"tag":45,"props":123,"children":124},{"style":63},[125],{"type":18,"value":126}," pPresentIds;\n",{"type":13,"tag":45,"props":128,"children":130},{"class":47,"line":129},6,[131],{"type":13,"tag":45,"props":132,"children":133},{"style":63},[134],{"type":18,"value":135},"} VkPresentIdKHR;\n",{"type":13,"tag":33,"props":137,"children":142},{"className":138,"code":139,"filename":140,"language":141,"meta":39,"style":39},"language-rs shiki shiki-themes github-light-default github-dark-default","pub struct PresentIdKHR {\n    s_type: vk::StructureType,\n    p_next: *const c_void,\n    swapchain_count: u32, // Copy of VkPresentInfoKHR::swapchainCount\n    p_present_ids: *const u64, // Present ID values for each swapchain\n}\n","Rust","rs",[143],{"type":13,"tag":21,"props":144,"children":145},{"__ignoreMap":39},[146,169,202,224,252,282],{"type":13,"tag":45,"props":147,"children":148},{"class":47,"line":48},[149,154,158,164],{"type":13,"tag":45,"props":150,"children":151},{"style":52},[152],{"type":18,"value":153},"pub",{"type":13,"tag":45,"props":155,"children":156},{"style":52},[157],{"type":18,"value":60},{"type":13,"tag":45,"props":159,"children":161},{"style":160},"--shiki-default:#953800;--shiki-dark:#FFA657",[162],{"type":18,"value":163}," PresentIdKHR",{"type":13,"tag":45,"props":165,"children":166},{"style":63},[167],{"type":18,"value":168}," {\n",{"type":13,"tag":45,"props":170,"children":171},{"class":47,"line":69},[172,177,182,187,192,197],{"type":13,"tag":45,"props":173,"children":174},{"style":63},[175],{"type":18,"value":176},"    s_type",{"type":13,"tag":45,"props":178,"children":179},{"style":52},[180],{"type":18,"value":181},":",{"type":13,"tag":45,"props":183,"children":184},{"style":160},[185],{"type":18,"value":186}," vk",{"type":13,"tag":45,"props":188,"children":189},{"style":52},[190],{"type":18,"value":191},"::",{"type":13,"tag":45,"props":193,"children":194},{"style":160},[195],{"type":18,"value":196},"StructureType",{"type":13,"tag":45,"props":198,"children":199},{"style":63},[200],{"type":18,"value":201},",\n",{"type":13,"tag":45,"props":203,"children":204},{"class":47,"line":78},[205,210,214,219],{"type":13,"tag":45,"props":206,"children":207},{"style":63},[208],{"type":18,"value":209},"    p_next",{"type":13,"tag":45,"props":211,"children":212},{"style":52},[213],{"type":18,"value":181},{"type":13,"tag":45,"props":215,"children":216},{"style":52},[217],{"type":18,"value":218}," *const",{"type":13,"tag":45,"props":220,"children":221},{"style":63},[222],{"type":18,"value":223}," c_void,\n",{"type":13,"tag":45,"props":225,"children":226},{"class":47,"line":97},[227,232,236,241,246],{"type":13,"tag":45,"props":228,"children":229},{"style":63},[230],{"type":18,"value":231},"    swapchain_count",{"type":13,"tag":45,"props":233,"children":234},{"style":52},[235],{"type":18,"value":181},{"type":13,"tag":45,"props":237,"children":238},{"style":160},[239],{"type":18,"value":240}," u32",{"type":13,"tag":45,"props":242,"children":243},{"style":63},[244],{"type":18,"value":245},", ",{"type":13,"tag":45,"props":247,"children":249},{"style":248},"--shiki-default:#6E7781;--shiki-dark:#8B949E",[250],{"type":18,"value":251},"// Copy of VkPresentInfoKHR::swapchainCount\n",{"type":13,"tag":45,"props":253,"children":254},{"class":47,"line":111},[255,260,264,268,273,277],{"type":13,"tag":45,"props":256,"children":257},{"style":63},[258],{"type":18,"value":259},"    p_present_ids",{"type":13,"tag":45,"props":261,"children":262},{"style":52},[263],{"type":18,"value":181},{"type":13,"tag":45,"props":265,"children":266},{"style":52},[267],{"type":18,"value":218},{"type":13,"tag":45,"props":269,"children":270},{"style":160},[271],{"type":18,"value":272}," u64",{"type":13,"tag":45,"props":274,"children":275},{"style":63},[276],{"type":18,"value":245},{"type":13,"tag":45,"props":278,"children":279},{"style":248},[280],{"type":18,"value":281},"// Present ID values for each swapchain\n",{"type":13,"tag":45,"props":283,"children":284},{"class":47,"line":129},[285],{"type":13,"tag":45,"props":286,"children":287},{"style":63},[288],{"type":18,"value":289},"}\n",{"type":13,"tag":291,"props":292,"children":293},"ul",{},[294,315,334,353],{"type":13,"tag":295,"props":296,"children":297},"li",{},[298,304,306,313],{"type":13,"tag":21,"props":299,"children":301},{"className":300},[],[302],{"type":18,"value":303},"sType",{"type":18,"value":305}," is a ",{"type":13,"tag":307,"props":308,"children":310},"a",{"href":309},"/man/VkStructureType",[311],{"type":18,"value":312},"VkStructureType",{"type":18,"value":314}," value identifying this structure.",{"type":13,"tag":295,"props":316,"children":317},{},[318,324,326,332],{"type":13,"tag":21,"props":319,"children":321},{"className":320},[],[322],{"type":18,"value":323},"pNext",{"type":18,"value":325}," is ",{"type":13,"tag":21,"props":327,"children":329},{"className":328},[],[330],{"type":18,"value":331},"NULL",{"type":18,"value":333}," or a pointer to a structure extending this\nstructure.",{"type":13,"tag":295,"props":335,"children":336},{},[337,343,345,351],{"type":13,"tag":21,"props":338,"children":340},{"className":339},[],[341],{"type":18,"value":342},"swapchainCount",{"type":18,"value":344}," is the number of swapchains being presented to the\n",{"type":13,"tag":21,"props":346,"children":348},{"className":347},[],[349],{"type":18,"value":350},"vkQueuePresentKHR",{"type":18,"value":352}," command.",{"type":13,"tag":295,"props":354,"children":355},{},[356,362,363,368,370,376,378,383,385,390,392,397,399,404],{"type":13,"tag":21,"props":357,"children":359},{"className":358},[],[360],{"type":18,"value":361},"pPresentIds",{"type":18,"value":325},{"type":13,"tag":21,"props":364,"children":366},{"className":365},[],[367],{"type":18,"value":331},{"type":18,"value":369}," or a pointer to an array of ",{"type":13,"tag":21,"props":371,"children":373},{"className":372},[],[374],{"type":18,"value":375},"uint64_t",{"type":18,"value":377},"\nwith ",{"type":13,"tag":21,"props":379,"children":381},{"className":380},[],[382],{"type":18,"value":342},{"type":18,"value":384}," entries.\nIf not ",{"type":13,"tag":21,"props":386,"children":388},{"className":387},[],[389],{"type":18,"value":331},{"type":18,"value":391},", each non-zero value in ",{"type":13,"tag":21,"props":393,"children":395},{"className":394},[],[396],{"type":18,"value":361},{"type":18,"value":398}," specifies the\npresent id to be associated with the presentation of the swapchain with\nthe same index in the ",{"type":13,"tag":307,"props":400,"children":402},{"href":401},"/man/vkQueuePresentKHR",[403],{"type":18,"value":350},{"type":18,"value":405}," call.",{"type":13,"tag":14,"props":407,"children":408},{},[409,411,416,418,428,430,435,437,442,444,449,451,457],{"type":18,"value":410},"For applications to be able to reference specific presentation events queued\nby a call to ",{"type":13,"tag":21,"props":412,"children":414},{"className":413},[],[415],{"type":18,"value":350},{"type":18,"value":417},", an identifier needs to be associated\nwith them.\nWhen the ",{"type":13,"tag":307,"props":419,"children":421},{"href":420},"/man/VkPhysicalDevicePresentIdFeaturesKHR#features-presentId",[422],{"type":13,"tag":21,"props":423,"children":425},{"className":424},[],[426],{"type":18,"value":427},"presentId",{"type":18,"value":429}," feature is enabled,\napplications ",{"type":13,"tag":431,"props":432,"children":434},"normative",{"type":433},"can",[],{"type":18,"value":436}," include the ",{"type":13,"tag":21,"props":438,"children":440},{"className":439},[],[441],{"type":18,"value":4},{"type":18,"value":443}," structure in the\n",{"type":13,"tag":21,"props":445,"children":447},{"className":446},[],[448],{"type":18,"value":323},{"type":18,"value":450}," chain of the ",{"type":13,"tag":307,"props":452,"children":454},{"href":453},"/man/VkPresentInfoKHR",[455],{"type":18,"value":456},"VkPresentInfoKHR",{"type":18,"value":458}," structure to supply\nidentifiers.",{"type":13,"tag":14,"props":460,"children":461},{},[462,464,470,472,477],{"type":18,"value":463},"Each ",{"type":13,"tag":21,"props":465,"children":467},{"className":466},[],[468],{"type":18,"value":469},"VkSwapchainKHR",{"type":18,"value":471}," has a presentId associated with it.\nThis value is initially zero when the ",{"type":13,"tag":21,"props":473,"children":475},{"className":474},[],[476],{"type":18,"value":469},{"type":18,"value":478}," is created.",{"type":13,"tag":14,"props":480,"children":481},{},[482,484,489,491,496,498,503,505,509,511,517,519,524,526,531,533,536,538,542],{"type":18,"value":483},"When a ",{"type":13,"tag":21,"props":485,"children":487},{"className":486},[],[488],{"type":18,"value":4},{"type":18,"value":490}," structure with a non-NULL ",{"type":13,"tag":21,"props":492,"children":494},{"className":493},[],[495],{"type":18,"value":361},{"type":18,"value":497}," is\nincluded in the ",{"type":13,"tag":21,"props":499,"children":501},{"className":500},[],[502],{"type":18,"value":323},{"type":18,"value":504}," chain of a ",{"type":13,"tag":307,"props":506,"children":507},{"href":453},[508],{"type":18,"value":456},{"type":18,"value":510}," structure,\neach ",{"type":13,"tag":21,"props":512,"children":514},{"className":513},[],[515],{"type":18,"value":516},"pSwapchains",{"type":18,"value":518}," entry has a presentId associated in the\n",{"type":13,"tag":21,"props":520,"children":522},{"className":521},[],[523],{"type":18,"value":361},{"type":18,"value":525}," array at the same index as the swapchain in the\n",{"type":13,"tag":21,"props":527,"children":529},{"className":528},[],[530],{"type":18,"value":516},{"type":18,"value":532}," array.\nIf this presentId is non-zero, then the application ",{"type":13,"tag":431,"props":534,"children":535},{"type":433},[],{"type":18,"value":537}," later use this\nvalue to refer to that image presentation.\nA value of zero indicates that this presentation has no associated\npresentId.\nA non-zero presentId ",{"type":13,"tag":431,"props":539,"children":541},{"type":540},"must",[],{"type":18,"value":543}," be greater than any non-zero presentId passed\npreviously by the application for the same swapchain.",{"type":13,"tag":14,"props":545,"children":546},{},[547,549,553],{"type":18,"value":548},"There is no requirement for any precise timing relationship between the\npresentation of the image to the user and the update of the presentId value,\nbut implementations ",{"type":13,"tag":431,"props":550,"children":552},{"type":551},"should",[],{"type":18,"value":554}," make this as close as possible to the\npresentation of the first pixel in the new image to the user.",{"type":13,"tag":556,"props":557,"children":559},"validity-group",{"name":558},"Valid Usage",[560,614],{"type":13,"tag":561,"props":562,"children":564},"validity-field",{"name":563},"VUID-VkPresentIdKHR-swapchainCount-04998",[565],{"type":13,"tag":14,"props":566,"children":567},{},[568,573,575,578,580,585,586,591,593,598,600,605,607,612],{"type":13,"tag":21,"props":569,"children":571},{"className":570},[],[572],{"type":18,"value":342},{"type":18,"value":574}," ",{"type":13,"tag":431,"props":576,"children":577},{"type":540},[],{"type":18,"value":579}," be the same value as\n",{"type":13,"tag":21,"props":581,"children":583},{"className":582},[],[584],{"type":18,"value":456},{"type":18,"value":191},{"type":13,"tag":21,"props":587,"children":589},{"className":588},[],[590],{"type":18,"value":342},{"type":18,"value":592},", where this\n",{"type":13,"tag":21,"props":594,"children":596},{"className":595},[],[597],{"type":18,"value":4},{"type":18,"value":599}," is in the ",{"type":13,"tag":21,"props":601,"children":603},{"className":602},[],[604],{"type":18,"value":323},{"type":18,"value":606}," chain of the\n",{"type":13,"tag":21,"props":608,"children":610},{"className":609},[],[611],{"type":18,"value":456},{"type":18,"value":613}," structure",{"type":13,"tag":561,"props":615,"children":617},{"name":616},"VUID-VkPresentIdKHR-presentIds-04999",[618],{"type":13,"tag":14,"props":619,"children":620},{},[621,622,628,630,633,635,640,642,647],{"type":18,"value":463},{"type":13,"tag":21,"props":623,"children":625},{"className":624},[],[626],{"type":18,"value":627},"presentIds",{"type":18,"value":629}," entry ",{"type":13,"tag":431,"props":631,"children":632},{"type":540},[],{"type":18,"value":634}," be greater than any previous\n",{"type":13,"tag":21,"props":636,"children":638},{"className":637},[],[639],{"type":18,"value":627},{"type":18,"value":641}," entry passed for the associated ",{"type":13,"tag":21,"props":643,"children":645},{"className":644},[],[646],{"type":18,"value":516},{"type":18,"value":648}," entry",{"type":13,"tag":556,"props":650,"children":652},{"name":651},"Valid Usage (Implicit)",[653,677,723],{"type":13,"tag":561,"props":654,"children":656},{"name":655},"VUID-VkPresentIdKHR-sType-sType",[657],{"type":13,"tag":14,"props":658,"children":659},{},[660,665,666,669,671],{"type":13,"tag":21,"props":661,"children":663},{"className":662},[],[664],{"type":18,"value":303},{"type":18,"value":574},{"type":13,"tag":431,"props":667,"children":668},{"type":540},[],{"type":18,"value":670}," be ",{"type":13,"tag":21,"props":672,"children":674},{"className":673},[],[675],{"type":18,"value":676},"VK_STRUCTURE_TYPE_PRESENT_ID_KHR",{"type":13,"tag":561,"props":678,"children":680},{"name":679},"VUID-VkPresentIdKHR-pPresentIds-parameter",[681],{"type":13,"tag":14,"props":682,"children":683},{},[684,686,691,693,698,699,704,705,708,710,715,716,721],{"type":18,"value":685},"If ",{"type":13,"tag":21,"props":687,"children":689},{"className":688},[],[690],{"type":18,"value":361},{"type":18,"value":692}," is not ",{"type":13,"tag":21,"props":694,"children":696},{"className":695},[],[697],{"type":18,"value":331},{"type":18,"value":245},{"type":13,"tag":21,"props":700,"children":702},{"className":701},[],[703],{"type":18,"value":361},{"type":18,"value":574},{"type":13,"tag":431,"props":706,"children":707},{"type":540},[],{"type":18,"value":709}," be a valid pointer to an array of ",{"type":13,"tag":21,"props":711,"children":713},{"className":712},[],[714],{"type":18,"value":342},{"type":18,"value":574},{"type":13,"tag":21,"props":717,"children":719},{"className":718},[],[720],{"type":18,"value":375},{"type":18,"value":722}," values",{"type":13,"tag":561,"props":724,"children":726},{"name":725},"VUID-VkPresentIdKHR-swapchainCount-arraylength",[727],{"type":13,"tag":14,"props":728,"children":729},{},[730,735,736,739,741],{"type":13,"tag":21,"props":731,"children":733},{"className":732},[],[734],{"type":18,"value":342},{"type":18,"value":574},{"type":13,"tag":431,"props":737,"children":738},{"type":540},[],{"type":18,"value":740}," be greater than ",{"type":13,"tag":21,"props":742,"children":744},{"className":743},[],[745],{"type":18,"value":746},"0",{"type":13,"tag":748,"props":749,"children":750},"style",{},[751],{"type":18,"value":752},"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":39,"searchDepth":69,"depth":69,"links":754},[],"markdown",1729612474831]