[{"data":1,"prerenderedAt":1541},["ShallowReactive",2],{"hMuLkhxzEN":3},{"title":4,"description":5,"parent":6,"type":7,"xrefs":8,"body":9,"_type":1540,"_id":4},"vkCreateSwapchainKHR","Create a swapchain","VK_KHR_swapchain","protos",[],{"type":10,"children":11,"toc":1538},"root",[12,20,405,477,497,522,1006,1025,1064,1086,1102,1186,1220,1229,1248,1271,1317,1376,1493,1532],{"type":13,"tag":14,"props":15,"children":16},"element","p",{},[17],{"type":18,"value":19},"text","To create a swapchain, call:",{"type":13,"tag":21,"props":22,"children":23},"code-group",{},[24,157],{"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 vkCreateSwapchainKHR(\n    VkDevice device,\n    const VkSwapchainCreateInfoKHR* pCreateInfo,\n    const VkAllocationCallbacks* pAllocator,\n    VkSwapchainKHR* pSwapchain);\n","C","c","",[33],{"type":13,"tag":34,"props":35,"children":36},"code",{"__ignoreMap":31},[37,59,79,108,134],{"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},"    VkDevice ",{"type":13,"tag":38,"props":69,"children":71},{"style":70},"--shiki-default:#953800;--shiki-dark:#FFA657",[72],{"type":18,"value":73},"device",{"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}," VkSwapchainCreateInfoKHR",{"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}," pCreateInfo",{"type":13,"tag":38,"props":105,"children":106},{"style":45},[107],{"type":18,"value":78},{"type":13,"tag":38,"props":109,"children":111},{"class":40,"line":110},4,[112,116,121,125,130],{"type":13,"tag":38,"props":113,"children":114},{"style":85},[115],{"type":18,"value":88},{"type":13,"tag":38,"props":117,"children":118},{"style":45},[119],{"type":18,"value":120}," VkAllocationCallbacks",{"type":13,"tag":38,"props":122,"children":123},{"style":85},[124],{"type":18,"value":98},{"type":13,"tag":38,"props":126,"children":127},{"style":70},[128],{"type":18,"value":129}," pAllocator",{"type":13,"tag":38,"props":131,"children":132},{"style":45},[133],{"type":18,"value":78},{"type":13,"tag":38,"props":135,"children":137},{"class":40,"line":136},5,[138,143,147,152],{"type":13,"tag":38,"props":139,"children":140},{"style":45},[141],{"type":18,"value":142},"    VkSwapchainKHR",{"type":13,"tag":38,"props":144,"children":145},{"style":85},[146],{"type":18,"value":98},{"type":13,"tag":38,"props":148,"children":149},{"style":70},[150],{"type":18,"value":151}," pSwapchain",{"type":13,"tag":38,"props":153,"children":154},{"style":45},[155],{"type":18,"value":156},");\n",{"type":13,"tag":25,"props":158,"children":163},{"className":159,"code":160,"filename":161,"language":162,"meta":31,"style":31},"language-rs shiki shiki-themes github-light-default github-dark-default","pub fn create_swapchain_khr(\n    device: crate :: vk :: vk::Device,\n    p_create_info: *const vk::SwapchainCreateInfoKHR,\n    p_create_info: *const vk::SwapchainCreateInfoKHR,\n    p_allocator: *const vk::AllocationCallbacks,\n    p_swapchain: *mut vk::SwapchainKHR,\n) -> vk::Result;\n","Rust","rs",[164],{"type":13,"tag":34,"props":165,"children":166},{"__ignoreMap":31},[167,189,240,274,305,338,373],{"type":13,"tag":38,"props":168,"children":169},{"class":40,"line":41},[170,175,180,185],{"type":13,"tag":38,"props":171,"children":172},{"style":85},[173],{"type":18,"value":174},"pub",{"type":13,"tag":38,"props":176,"children":177},{"style":85},[178],{"type":18,"value":179}," fn",{"type":13,"tag":38,"props":181,"children":182},{"style":51},[183],{"type":18,"value":184}," create_swapchain_khr",{"type":13,"tag":38,"props":186,"children":187},{"style":45},[188],{"type":18,"value":58},{"type":13,"tag":38,"props":190,"children":191},{"class":40,"line":61},[192,197,202,207,212,217,222,227,231,236],{"type":13,"tag":38,"props":193,"children":194},{"style":45},[195],{"type":18,"value":196},"    device",{"type":13,"tag":38,"props":198,"children":199},{"style":85},[200],{"type":18,"value":201},":",{"type":13,"tag":38,"props":203,"children":204},{"style":85},[205],{"type":18,"value":206}," crate",{"type":13,"tag":38,"props":208,"children":209},{"style":85},[210],{"type":18,"value":211}," ::",{"type":13,"tag":38,"props":213,"children":214},{"style":45},[215],{"type":18,"value":216}," vk ",{"type":13,"tag":38,"props":218,"children":219},{"style":85},[220],{"type":18,"value":221},"::",{"type":13,"tag":38,"props":223,"children":224},{"style":70},[225],{"type":18,"value":226}," vk",{"type":13,"tag":38,"props":228,"children":229},{"style":85},[230],{"type":18,"value":221},{"type":13,"tag":38,"props":232,"children":233},{"style":70},[234],{"type":18,"value":235},"Device",{"type":13,"tag":38,"props":237,"children":238},{"style":45},[239],{"type":18,"value":78},{"type":13,"tag":38,"props":241,"children":242},{"class":40,"line":81},[243,248,252,257,261,265,270],{"type":13,"tag":38,"props":244,"children":245},{"style":45},[246],{"type":18,"value":247},"    p_create_info",{"type":13,"tag":38,"props":249,"children":250},{"style":85},[251],{"type":18,"value":201},{"type":13,"tag":38,"props":253,"children":254},{"style":85},[255],{"type":18,"value":256}," *const",{"type":13,"tag":38,"props":258,"children":259},{"style":70},[260],{"type":18,"value":226},{"type":13,"tag":38,"props":262,"children":263},{"style":85},[264],{"type":18,"value":221},{"type":13,"tag":38,"props":266,"children":267},{"style":70},[268],{"type":18,"value":269},"SwapchainCreateInfoKHR",{"type":13,"tag":38,"props":271,"children":272},{"style":45},[273],{"type":18,"value":78},{"type":13,"tag":38,"props":275,"children":276},{"class":40,"line":110},[277,281,285,289,293,297,301],{"type":13,"tag":38,"props":278,"children":279},{"style":45},[280],{"type":18,"value":247},{"type":13,"tag":38,"props":282,"children":283},{"style":85},[284],{"type":18,"value":201},{"type":13,"tag":38,"props":286,"children":287},{"style":85},[288],{"type":18,"value":256},{"type":13,"tag":38,"props":290,"children":291},{"style":70},[292],{"type":18,"value":226},{"type":13,"tag":38,"props":294,"children":295},{"style":85},[296],{"type":18,"value":221},{"type":13,"tag":38,"props":298,"children":299},{"style":70},[300],{"type":18,"value":269},{"type":13,"tag":38,"props":302,"children":303},{"style":45},[304],{"type":18,"value":78},{"type":13,"tag":38,"props":306,"children":307},{"class":40,"line":136},[308,313,317,321,325,329,334],{"type":13,"tag":38,"props":309,"children":310},{"style":45},[311],{"type":18,"value":312},"    p_allocator",{"type":13,"tag":38,"props":314,"children":315},{"style":85},[316],{"type":18,"value":201},{"type":13,"tag":38,"props":318,"children":319},{"style":85},[320],{"type":18,"value":256},{"type":13,"tag":38,"props":322,"children":323},{"style":70},[324],{"type":18,"value":226},{"type":13,"tag":38,"props":326,"children":327},{"style":85},[328],{"type":18,"value":221},{"type":13,"tag":38,"props":330,"children":331},{"style":70},[332],{"type":18,"value":333},"AllocationCallbacks",{"type":13,"tag":38,"props":335,"children":336},{"style":45},[337],{"type":18,"value":78},{"type":13,"tag":38,"props":339,"children":341},{"class":40,"line":340},6,[342,347,351,356,360,364,369],{"type":13,"tag":38,"props":343,"children":344},{"style":45},[345],{"type":18,"value":346},"    p_swapchain",{"type":13,"tag":38,"props":348,"children":349},{"style":85},[350],{"type":18,"value":201},{"type":13,"tag":38,"props":352,"children":353},{"style":85},[354],{"type":18,"value":355}," *mut",{"type":13,"tag":38,"props":357,"children":358},{"style":70},[359],{"type":18,"value":226},{"type":13,"tag":38,"props":361,"children":362},{"style":85},[363],{"type":18,"value":221},{"type":13,"tag":38,"props":365,"children":366},{"style":70},[367],{"type":18,"value":368},"SwapchainKHR",{"type":13,"tag":38,"props":370,"children":371},{"style":45},[372],{"type":18,"value":78},{"type":13,"tag":38,"props":374,"children":376},{"class":40,"line":375},7,[377,382,387,391,395,400],{"type":13,"tag":38,"props":378,"children":379},{"style":45},[380],{"type":18,"value":381},") ",{"type":13,"tag":38,"props":383,"children":384},{"style":85},[385],{"type":18,"value":386},"->",{"type":13,"tag":38,"props":388,"children":389},{"style":70},[390],{"type":18,"value":226},{"type":13,"tag":38,"props":392,"children":393},{"style":85},[394],{"type":18,"value":221},{"type":13,"tag":38,"props":396,"children":397},{"style":70},[398],{"type":18,"value":399},"Result",{"type":13,"tag":38,"props":401,"children":402},{"style":45},[403],{"type":18,"value":404},";\n",{"type":13,"tag":406,"props":407,"children":408},"ul",{},[409,420,440,459],{"type":13,"tag":410,"props":411,"children":412},"li",{},[413,418],{"type":13,"tag":34,"props":414,"children":416},{"className":415},[],[417],{"type":18,"value":73},{"type":18,"value":419}," is the device to create the swapchain for.",{"type":13,"tag":410,"props":421,"children":422},{},[423,429,431,438],{"type":13,"tag":34,"props":424,"children":426},{"className":425},[],[427],{"type":18,"value":428},"pCreateInfo",{"type":18,"value":430}," is a pointer to a ",{"type":13,"tag":432,"props":433,"children":435},"a",{"href":434},"/man/VkSwapchainCreateInfoKHR",[436],{"type":18,"value":437},"VkSwapchainCreateInfoKHR",{"type":18,"value":439},"\nstructure specifying the parameters of the created swapchain.",{"type":13,"tag":410,"props":441,"children":442},{},[443,449,451,457],{"type":13,"tag":34,"props":444,"children":446},{"className":445},[],[447],{"type":18,"value":448},"pAllocator",{"type":18,"value":450}," is the allocator used for host memory allocated for the\nswapchain object when there is no more specific allocator available (see\n",{"type":13,"tag":432,"props":452,"children":454},{"href":453},"/chapters/memory#memory-allocation",[455],{"type":18,"value":456},"Memory Allocation",{"type":18,"value":458},").",{"type":13,"tag":410,"props":460,"children":461},{},[462,468,469,475],{"type":13,"tag":34,"props":463,"children":465},{"className":464},[],[466],{"type":18,"value":467},"pSwapchain",{"type":18,"value":430},{"type":13,"tag":432,"props":470,"children":472},{"href":471},"/man/VkSwapchainKHR",[473],{"type":18,"value":474},"VkSwapchainKHR",{"type":18,"value":476}," handle in which\nthe created swapchain object will be returned.",{"type":13,"tag":14,"props":478,"children":479},{},[480,482,487,489,495],{"type":18,"value":481},"As mentioned above, if ",{"type":13,"tag":34,"props":483,"children":485},{"className":484},[],[486],{"type":18,"value":4},{"type":18,"value":488}," succeeds, it will return a\nhandle to a swapchain containing an array of at least\n",{"type":13,"tag":34,"props":490,"children":492},{"className":491},[],[493],{"type":18,"value":494},"pCreateInfo→minImageCount",{"type":18,"value":496}," presentable images.",{"type":13,"tag":14,"props":498,"children":499},{},[500,502,507,509,512,514,520],{"type":18,"value":501},"While acquired by the application, presentable images ",{"type":13,"tag":503,"props":504,"children":506},"normative",{"type":505},"can",[],{"type":18,"value":508}," be used in any\nway that equivalent non-presentable images ",{"type":13,"tag":503,"props":510,"children":511},{"type":505},[],{"type":18,"value":513}," be used.\nA presentable image is equivalent to a non-presentable image created with\nthe following ",{"type":13,"tag":432,"props":515,"children":517},{"href":516},"/man/VkImageCreateInfo",[518],{"type":18,"value":519},"VkImageCreateInfo",{"type":18,"value":521}," parameters:",{"type":13,"tag":523,"props":524,"children":531},"table",{"id":525,"className":526},"swapchain-wsi-image-create-info",[527,528,529,530],"tableblock","frame-all","grid-all","stretch",[532,544,572],{"type":13,"tag":533,"props":534,"children":535},"colgroup",{},[536,541],{"type":13,"tag":537,"props":538,"children":540},"col",{"style":539},"width: 50%;",[],{"type":13,"tag":537,"props":542,"children":543},{"style":539},[],{"type":13,"tag":545,"props":546,"children":547},"thead",{},[548],{"type":13,"tag":549,"props":550,"children":551},"tr",{},[552,566],{"type":13,"tag":553,"props":554,"children":558},"th",{"className":555},[527,556,557],"halign-left","valign-top",[559,564],{"type":13,"tag":560,"props":561,"children":562},"literal",{},[563],{"type":18,"value":519},{"type":18,"value":565}," Field",{"type":13,"tag":553,"props":567,"children":569},{"className":568},[527,556,557],[570],{"type":18,"value":571},"Value",{"type":13,"tag":573,"props":574,"children":575},"tbody",{},[576,645,674,703,749,774,803,832,861,890,919,948,977],{"type":13,"tag":549,"props":577,"children":578},{},[579,593],{"type":13,"tag":580,"props":581,"children":583},"td",{"className":582},[527,556,557],[584],{"type":13,"tag":14,"props":585,"children":587},{"className":586},[527],[588],{"type":13,"tag":560,"props":589,"children":590},{},[591],{"type":18,"value":592},"flags",{"type":13,"tag":580,"props":594,"children":596},{"className":595},[527,556,557],[597,615,639],{"type":13,"tag":14,"props":598,"children":600},{"className":599},[527],[601,606,608,613],{"type":13,"tag":560,"props":602,"children":603},{},[604],{"type":18,"value":605},"VK_IMAGE_CREATE_SPLIT_INSTANCE_BIND_REGIONS_BIT",{"type":18,"value":607}," is set if\n",{"type":13,"tag":560,"props":609,"children":610},{},[611],{"type":18,"value":612},"VK_SWAPCHAIN_CREATE_SPLIT_INSTANCE_BIND_REGIONS_BIT_KHR",{"type":18,"value":614}," is set",{"type":13,"tag":14,"props":616,"children":618},{"className":617},[527],[619,624,626,631,633,638],{"type":13,"tag":560,"props":620,"children":621},{},[622],{"type":18,"value":623},"VK_IMAGE_CREATE_MUTABLE_FORMAT_BIT",{"type":18,"value":625}," and\n",{"type":13,"tag":560,"props":627,"children":628},{},[629],{"type":18,"value":630},"VK_IMAGE_CREATE_EXTENDED_USAGE_BIT_KHR",{"type":18,"value":632}," are both set if\n",{"type":13,"tag":560,"props":634,"children":635},{},[636],{"type":18,"value":637},"VK_SWAPCHAIN_CREATE_MUTABLE_FORMAT_BIT_KHR",{"type":18,"value":614},{"type":13,"tag":14,"props":640,"children":642},{"className":641},[527],[643],{"type":18,"value":644},"all other bits are unset",{"type":13,"tag":549,"props":646,"children":647},{},[648,661],{"type":13,"tag":580,"props":649,"children":651},{"className":650},[527,556,557],[652],{"type":13,"tag":14,"props":653,"children":655},{"className":654},[527],[656],{"type":13,"tag":560,"props":657,"children":658},{},[659],{"type":18,"value":660},"imageType",{"type":13,"tag":580,"props":662,"children":664},{"className":663},[527,556,557],[665],{"type":13,"tag":14,"props":666,"children":668},{"className":667},[527],[669],{"type":13,"tag":560,"props":670,"children":671},{},[672],{"type":18,"value":673},"VK_IMAGE_TYPE_2D",{"type":13,"tag":549,"props":675,"children":676},{},[677,690],{"type":13,"tag":580,"props":678,"children":680},{"className":679},[527,556,557],[681],{"type":13,"tag":14,"props":682,"children":684},{"className":683},[527],[685],{"type":13,"tag":560,"props":686,"children":687},{},[688],{"type":18,"value":689},"format",{"type":13,"tag":580,"props":691,"children":693},{"className":692},[527,556,557],[694],{"type":13,"tag":14,"props":695,"children":697},{"className":696},[527],[698],{"type":13,"tag":560,"props":699,"children":700},{},[701],{"type":18,"value":702},"pCreateInfo→imageFormat",{"type":13,"tag":549,"props":704,"children":705},{},[706,719],{"type":13,"tag":580,"props":707,"children":709},{"className":708},[527,556,557],[710],{"type":13,"tag":14,"props":711,"children":713},{"className":712},[527],[714],{"type":13,"tag":560,"props":715,"children":716},{},[717],{"type":18,"value":718},"extent",{"type":13,"tag":580,"props":720,"children":722},{"className":721},[527,556,557],[723],{"type":13,"tag":14,"props":724,"children":726},{"className":725},[527],[727,729,734,736,741,742,747],{"type":18,"value":728},"{",{"type":13,"tag":560,"props":730,"children":731},{},[732],{"type":18,"value":733},"pCreateInfo→imageExtent.width",{"type":18,"value":735},", ",{"type":13,"tag":560,"props":737,"children":738},{},[739],{"type":18,"value":740},"pCreateInfo→imageExtent.height",{"type":18,"value":735},{"type":13,"tag":560,"props":743,"children":744},{},[745],{"type":18,"value":746},"1",{"type":18,"value":748},"}",{"type":13,"tag":549,"props":750,"children":751},{},[752,765],{"type":13,"tag":580,"props":753,"children":755},{"className":754},[527,556,557],[756],{"type":13,"tag":14,"props":757,"children":759},{"className":758},[527],[760],{"type":13,"tag":560,"props":761,"children":762},{},[763],{"type":18,"value":764},"mipLevels",{"type":13,"tag":580,"props":766,"children":768},{"className":767},[527,556,557],[769],{"type":13,"tag":14,"props":770,"children":772},{"className":771},[527],[773],{"type":18,"value":746},{"type":13,"tag":549,"props":775,"children":776},{},[777,790],{"type":13,"tag":580,"props":778,"children":780},{"className":779},[527,556,557],[781],{"type":13,"tag":14,"props":782,"children":784},{"className":783},[527],[785],{"type":13,"tag":560,"props":786,"children":787},{},[788],{"type":18,"value":789},"arrayLayers",{"type":13,"tag":580,"props":791,"children":793},{"className":792},[527,556,557],[794],{"type":13,"tag":14,"props":795,"children":797},{"className":796},[527],[798],{"type":13,"tag":560,"props":799,"children":800},{},[801],{"type":18,"value":802},"pCreateInfo→imageArrayLayers",{"type":13,"tag":549,"props":804,"children":805},{},[806,819],{"type":13,"tag":580,"props":807,"children":809},{"className":808},[527,556,557],[810],{"type":13,"tag":14,"props":811,"children":813},{"className":812},[527],[814],{"type":13,"tag":560,"props":815,"children":816},{},[817],{"type":18,"value":818},"samples",{"type":13,"tag":580,"props":820,"children":822},{"className":821},[527,556,557],[823],{"type":13,"tag":14,"props":824,"children":826},{"className":825},[527],[827],{"type":13,"tag":560,"props":828,"children":829},{},[830],{"type":18,"value":831},"VK_SAMPLE_COUNT_1_BIT",{"type":13,"tag":549,"props":833,"children":834},{},[835,848],{"type":13,"tag":580,"props":836,"children":838},{"className":837},[527,556,557],[839],{"type":13,"tag":14,"props":840,"children":842},{"className":841},[527],[843],{"type":13,"tag":560,"props":844,"children":845},{},[846],{"type":18,"value":847},"tiling",{"type":13,"tag":580,"props":849,"children":851},{"className":850},[527,556,557],[852],{"type":13,"tag":14,"props":853,"children":855},{"className":854},[527],[856],{"type":13,"tag":560,"props":857,"children":858},{},[859],{"type":18,"value":860},"VK_IMAGE_TILING_OPTIMAL",{"type":13,"tag":549,"props":862,"children":863},{},[864,877],{"type":13,"tag":580,"props":865,"children":867},{"className":866},[527,556,557],[868],{"type":13,"tag":14,"props":869,"children":871},{"className":870},[527],[872],{"type":13,"tag":560,"props":873,"children":874},{},[875],{"type":18,"value":876},"usage",{"type":13,"tag":580,"props":878,"children":880},{"className":879},[527,556,557],[881],{"type":13,"tag":14,"props":882,"children":884},{"className":883},[527],[885],{"type":13,"tag":560,"props":886,"children":887},{},[888],{"type":18,"value":889},"pCreateInfo→imageUsage",{"type":13,"tag":549,"props":891,"children":892},{},[893,906],{"type":13,"tag":580,"props":894,"children":896},{"className":895},[527,556,557],[897],{"type":13,"tag":14,"props":898,"children":900},{"className":899},[527],[901],{"type":13,"tag":560,"props":902,"children":903},{},[904],{"type":18,"value":905},"sharingMode",{"type":13,"tag":580,"props":907,"children":909},{"className":908},[527,556,557],[910],{"type":13,"tag":14,"props":911,"children":913},{"className":912},[527],[914],{"type":13,"tag":560,"props":915,"children":916},{},[917],{"type":18,"value":918},"pCreateInfo→imageSharingMode",{"type":13,"tag":549,"props":920,"children":921},{},[922,935],{"type":13,"tag":580,"props":923,"children":925},{"className":924},[527,556,557],[926],{"type":13,"tag":14,"props":927,"children":929},{"className":928},[527],[930],{"type":13,"tag":560,"props":931,"children":932},{},[933],{"type":18,"value":934},"queueFamilyIndexCount",{"type":13,"tag":580,"props":936,"children":938},{"className":937},[527,556,557],[939],{"type":13,"tag":14,"props":940,"children":942},{"className":941},[527],[943],{"type":13,"tag":560,"props":944,"children":945},{},[946],{"type":18,"value":947},"pCreateInfo→queueFamilyIndexCount",{"type":13,"tag":549,"props":949,"children":950},{},[951,964],{"type":13,"tag":580,"props":952,"children":954},{"className":953},[527,556,557],[955],{"type":13,"tag":14,"props":956,"children":958},{"className":957},[527],[959],{"type":13,"tag":560,"props":960,"children":961},{},[962],{"type":18,"value":963},"pQueueFamilyIndices",{"type":13,"tag":580,"props":965,"children":967},{"className":966},[527,556,557],[968],{"type":13,"tag":14,"props":969,"children":971},{"className":970},[527],[972],{"type":13,"tag":560,"props":973,"children":974},{},[975],{"type":18,"value":976},"pCreateInfo→pQueueFamilyIndices",{"type":13,"tag":549,"props":978,"children":979},{},[980,993],{"type":13,"tag":580,"props":981,"children":983},{"className":982},[527,556,557],[984],{"type":13,"tag":14,"props":985,"children":987},{"className":986},[527],[988],{"type":13,"tag":560,"props":989,"children":990},{},[991],{"type":18,"value":992},"initialLayout",{"type":13,"tag":580,"props":994,"children":996},{"className":995},[527,556,557],[997],{"type":13,"tag":14,"props":998,"children":1000},{"className":999},[527],[1001],{"type":13,"tag":560,"props":1002,"children":1003},{},[1004],{"type":18,"value":1005},"VK_IMAGE_LAYOUT_UNDEFINED",{"type":13,"tag":14,"props":1007,"children":1008},{},[1009,1011,1017,1019,1023],{"type":18,"value":1010},"The ",{"type":13,"tag":34,"props":1012,"children":1014},{"className":1013},[],[1015],{"type":18,"value":1016},"pCreateInfo→surface",{"type":18,"value":1018}," ",{"type":13,"tag":503,"props":1020,"children":1022},{"type":1021},"must",[],{"type":18,"value":1024}," not be destroyed until after the\nswapchain is destroyed.",{"type":13,"tag":14,"props":1026,"children":1027},{},[1028,1030,1036,1038,1044,1046,1051,1053,1059,1062],{"type":18,"value":1029},"If ",{"type":13,"tag":34,"props":1031,"children":1033},{"className":1032},[],[1034],{"type":18,"value":1035},"oldSwapchain",{"type":18,"value":1037}," is ",{"type":13,"tag":432,"props":1039,"children":1041},{"href":1040},"/man/VK_NULL_HANDLE",[1042],{"type":18,"value":1043},"VK_NULL_HANDLE",{"type":18,"value":1045},", and\nthe native window referred to by ",{"type":13,"tag":34,"props":1047,"children":1049},{"className":1048},[],[1050],{"type":18,"value":1016},{"type":18,"value":1052}," is already\nassociated with a Vulkan swapchain, ",{"type":13,"tag":34,"props":1054,"children":1056},{"className":1055},[],[1057],{"type":18,"value":1058},"VK_ERROR_NATIVE_WINDOW_IN_USE_KHR",{"type":13,"tag":503,"props":1060,"children":1061},{"type":1021},[],{"type":18,"value":1063}," be returned.",{"type":13,"tag":14,"props":1065,"children":1066},{},[1067,1069,1074,1076,1081,1082,1085],{"type":18,"value":1068},"If the native window referred to by ",{"type":13,"tag":34,"props":1070,"children":1072},{"className":1071},[],[1073],{"type":18,"value":1016},{"type":18,"value":1075}," is already\nassociated with a non-Vulkan graphics API surface,\n",{"type":13,"tag":34,"props":1077,"children":1079},{"className":1078},[],[1080],{"type":18,"value":1058},{"type":18,"value":1018},{"type":13,"tag":503,"props":1083,"children":1084},{"type":1021},[],{"type":18,"value":1063},{"type":13,"tag":14,"props":1087,"children":1088},{},[1089,1091,1096,1097,1100],{"type":18,"value":1090},"The native window referred to by ",{"type":13,"tag":34,"props":1092,"children":1094},{"className":1093},[],[1095],{"type":18,"value":1016},{"type":18,"value":1018},{"type":13,"tag":503,"props":1098,"children":1099},{"type":1021},[],{"type":18,"value":1101}," not become\nassociated with a non-Vulkan graphics API surface before all associated\nVulkan swapchains have been destroyed.",{"type":13,"tag":14,"props":1103,"children":1104},{},[1105,1110,1112,1118,1120,1125,1127,1132,1134,1137,1139,1144,1146,1152,1154,1160,1162,1167,1169,1174,1177,1179,1184],{"type":13,"tag":34,"props":1106,"children":1108},{"className":1107},[],[1109],{"type":18,"value":4},{"type":18,"value":1111}," will return ",{"type":13,"tag":34,"props":1113,"children":1115},{"className":1114},[],[1116],{"type":18,"value":1117},"VK_ERROR_DEVICE_LOST",{"type":18,"value":1119}," if the\nlogical device was lost.\nThe ",{"type":13,"tag":34,"props":1121,"children":1123},{"className":1122},[],[1124],{"type":18,"value":474},{"type":18,"value":1126}," is a child of the ",{"type":13,"tag":34,"props":1128,"children":1130},{"className":1129},[],[1131],{"type":18,"value":73},{"type":18,"value":1133},", and ",{"type":13,"tag":503,"props":1135,"children":1136},{"type":1021},[],{"type":18,"value":1138}," be\ndestroyed before the ",{"type":13,"tag":34,"props":1140,"children":1142},{"className":1141},[],[1143],{"type":18,"value":73},{"type":18,"value":1145},".\nHowever, ",{"type":13,"tag":34,"props":1147,"children":1149},{"className":1148},[],[1150],{"type":18,"value":1151},"VkSurfaceKHR",{"type":18,"value":1153}," is not a child of any ",{"type":13,"tag":34,"props":1155,"children":1157},{"className":1156},[],[1158],{"type":18,"value":1159},"VkDevice",{"type":18,"value":1161}," and is not\naffected by the lost device.\nAfter successfully recreating a ",{"type":13,"tag":34,"props":1163,"children":1165},{"className":1164},[],[1166],{"type":18,"value":1159},{"type":18,"value":1168},", the same ",{"type":13,"tag":34,"props":1170,"children":1172},{"className":1171},[],[1173],{"type":18,"value":1151},{"type":13,"tag":503,"props":1175,"children":1176},{"type":505},[],{"type":18,"value":1178}," be used to create a new ",{"type":13,"tag":34,"props":1180,"children":1182},{"className":1181},[],[1183],{"type":18,"value":474},{"type":18,"value":1185},", provided the previous one\nwas destroyed.",{"type":13,"tag":14,"props":1187,"children":1188},{},[1189,1191,1196,1198,1203,1205,1211,1213,1218],{"type":18,"value":1190},"If the ",{"type":13,"tag":34,"props":1192,"children":1194},{"className":1193},[],[1195],{"type":18,"value":1035},{"type":18,"value":1197}," parameter of ",{"type":13,"tag":34,"props":1199,"children":1201},{"className":1200},[],[1202],{"type":18,"value":428},{"type":18,"value":1204}," is a valid\nswapchain, which has exclusive full-screen access, that access is released\nfrom ",{"type":13,"tag":34,"props":1206,"children":1208},{"className":1207},[],[1209],{"type":18,"value":1210},"pCreateInfo→oldSwapchain",{"type":18,"value":1212},".\nIf the command succeeds in this case, the newly created swapchain will\nautomatically acquire exclusive full-screen access from\n",{"type":13,"tag":34,"props":1214,"children":1216},{"className":1215},[],[1217],{"type":18,"value":1210},{"type":18,"value":1219},".",{"type":13,"tag":1221,"props":1222,"children":1223},"note",{},[1224],{"type":13,"tag":14,"props":1225,"children":1226},{},[1227],{"type":18,"value":1228},"This implicit transfer is intended to avoid exiting and entering full-screen\nexclusive mode, which may otherwise cause unwanted visual updates to the\ndisplay.",{"type":13,"tag":14,"props":1230,"children":1231},{},[1232,1234,1238,1240,1246],{"type":18,"value":1233},"In some cases, swapchain creation ",{"type":13,"tag":503,"props":1235,"children":1237},{"type":1236},"may",[],{"type":18,"value":1239}," fail if exclusive full-screen mode is\nrequested for application control, but for some implementation-specific\nreason exclusive full-screen access is unavailable for the particular\ncombination of parameters provided.\nIf this occurs, ",{"type":13,"tag":34,"props":1241,"children":1243},{"className":1242},[],[1244],{"type":18,"value":1245},"VK_ERROR_INITIALIZATION_FAILED",{"type":18,"value":1247}," will be returned.",{"type":13,"tag":1221,"props":1249,"children":1250},{},[1251],{"type":13,"tag":14,"props":1252,"children":1253},{},[1254,1256,1262,1264,1269],{"type":18,"value":1255},"In particular, it will fail if the ",{"type":13,"tag":34,"props":1257,"children":1259},{"className":1258},[],[1260],{"type":18,"value":1261},"imageExtent",{"type":18,"value":1263}," member of\n",{"type":13,"tag":34,"props":1265,"children":1267},{"className":1266},[],[1268],{"type":18,"value":428},{"type":18,"value":1270}," does not match the extents of the monitor.\nOther reasons for failure may include the application not being set as\nhigh-dpi aware, or if the physical device and monitor are not compatible in\nthis mode.",{"type":13,"tag":14,"props":1272,"children":1273},{},[1274,1275,1281,1283,1287,1289,1295,1297,1300,1302,1308,1310,1315],{"type":18,"value":1190},{"type":13,"tag":34,"props":1276,"children":1278},{"className":1277},[],[1279],{"type":18,"value":1280},"pNext",{"type":18,"value":1282}," chain of ",{"type":13,"tag":432,"props":1284,"children":1285},{"href":434},[1286],{"type":18,"value":437},{"type":18,"value":1288}," includes a\n",{"type":13,"tag":432,"props":1290,"children":1292},{"href":1291},"/man/VkSwapchainPresentBarrierCreateInfoNV",[1293],{"type":18,"value":1294},"VkSwapchainPresentBarrierCreateInfoNV",{"type":18,"value":1296}," structure, then that structure\nincludes additional swapchain creation parameters specific to the present\nbarrier.\nSwapchain creation ",{"type":13,"tag":503,"props":1298,"children":1299},{"type":1236},[],{"type":18,"value":1301}," fail if the state of the current system restricts\nthe usage of the present barrier feature\n",{"type":13,"tag":432,"props":1303,"children":1305},{"href":1304},"/man/VkSurfaceCapabilitiesPresentBarrierNV",[1306],{"type":18,"value":1307},"VkSurfaceCapabilitiesPresentBarrierNV",{"type":18,"value":1309},", or a swapchain itself does not\nsatisfy all the required conditions.\nIn this scenario ",{"type":13,"tag":34,"props":1311,"children":1313},{"className":1312},[],[1314],{"type":18,"value":1245},{"type":18,"value":1316}," is returned.",{"type":13,"tag":14,"props":1318,"children":1319},{},[1320,1322,1327,1329,1333,1335,1341,1343,1349,1351,1357,1359,1362,1364,1368,1370,1375],{"type":18,"value":1321},"When the ",{"type":13,"tag":432,"props":1323,"children":1325},{"href":1324},"/man/VkSurfaceKHR",[1326],{"type":18,"value":1151},{"type":18,"value":1328}," in ",{"type":13,"tag":432,"props":1330,"children":1331},{"href":434},[1332],{"type":18,"value":437},{"type":18,"value":1334}," is a display\nsurface, then the ",{"type":13,"tag":432,"props":1336,"children":1338},{"href":1337},"/man/VkDisplayModeKHR",[1339],{"type":18,"value":1340},"VkDisplayModeKHR",{"type":18,"value":1342}," in display surface’s\n",{"type":13,"tag":432,"props":1344,"children":1346},{"href":1345},"/man/VkDisplaySurfaceCreateInfoKHR",[1347],{"type":18,"value":1348},"VkDisplaySurfaceCreateInfoKHR",{"type":18,"value":1350}," is associated with a particular\n",{"type":13,"tag":432,"props":1352,"children":1354},{"href":1353},"/man/VkDisplayKHR",[1355],{"type":18,"value":1356},"VkDisplayKHR",{"type":18,"value":1358},".\nSwapchain creation ",{"type":13,"tag":503,"props":1360,"children":1361},{"type":1236},[],{"type":18,"value":1363}," fail if that ",{"type":13,"tag":432,"props":1365,"children":1366},{"href":1353},[1367],{"type":18,"value":1356},{"type":18,"value":1369}," is not acquired by\nthe application.\nIn this scenario ",{"type":13,"tag":34,"props":1371,"children":1373},{"className":1372},[],[1374],{"type":18,"value":1245},{"type":18,"value":1316},{"type":13,"tag":1377,"props":1378,"children":1380},"validity-group",{"name":1379},"Valid Usage (Implicit)",[1381,1407,1431,1470],{"type":13,"tag":1382,"props":1383,"children":1385},"validity-field",{"name":1384},"VUID-vkCreateSwapchainKHR-device-parameter",[1386],{"type":13,"tag":14,"props":1387,"children":1388},{},[1389,1394,1395,1398,1400,1405],{"type":13,"tag":34,"props":1390,"children":1392},{"className":1391},[],[1393],{"type":18,"value":73},{"type":18,"value":1018},{"type":13,"tag":503,"props":1396,"children":1397},{"type":1021},[],{"type":18,"value":1399}," be a valid ",{"type":13,"tag":432,"props":1401,"children":1403},{"href":1402},"/man/VkDevice",[1404],{"type":18,"value":1159},{"type":18,"value":1406}," handle",{"type":13,"tag":1382,"props":1408,"children":1410},{"name":1409},"VUID-vkCreateSwapchainKHR-pCreateInfo-parameter",[1411],{"type":13,"tag":14,"props":1412,"children":1413},{},[1414,1419,1420,1423,1425,1429],{"type":13,"tag":34,"props":1415,"children":1417},{"className":1416},[],[1418],{"type":18,"value":428},{"type":18,"value":1018},{"type":13,"tag":503,"props":1421,"children":1422},{"type":1021},[],{"type":18,"value":1424}," be a valid pointer to a valid ",{"type":13,"tag":432,"props":1426,"children":1427},{"href":434},[1428],{"type":18,"value":437},{"type":18,"value":1430}," structure",{"type":13,"tag":1382,"props":1432,"children":1434},{"name":1433},"VUID-vkCreateSwapchainKHR-pAllocator-parameter",[1435],{"type":13,"tag":14,"props":1436,"children":1437},{},[1438,1439,1444,1446,1452,1453,1458,1459,1462,1463,1469],{"type":18,"value":1029},{"type":13,"tag":34,"props":1440,"children":1442},{"className":1441},[],[1443],{"type":18,"value":448},{"type":18,"value":1445}," is not ",{"type":13,"tag":34,"props":1447,"children":1449},{"className":1448},[],[1450],{"type":18,"value":1451},"NULL",{"type":18,"value":735},{"type":13,"tag":34,"props":1454,"children":1456},{"className":1455},[],[1457],{"type":18,"value":448},{"type":18,"value":1018},{"type":13,"tag":503,"props":1460,"children":1461},{"type":1021},[],{"type":18,"value":1424},{"type":13,"tag":432,"props":1464,"children":1466},{"href":1465},"/man/VkAllocationCallbacks",[1467],{"type":18,"value":1468},"VkAllocationCallbacks",{"type":18,"value":1430},{"type":13,"tag":1382,"props":1471,"children":1473},{"name":1472},"VUID-vkCreateSwapchainKHR-pSwapchain-parameter",[1474],{"type":13,"tag":14,"props":1475,"children":1476},{},[1477,1482,1483,1486,1488,1492],{"type":13,"tag":34,"props":1478,"children":1480},{"className":1479},[],[1481],{"type":18,"value":467},{"type":18,"value":1018},{"type":13,"tag":503,"props":1484,"children":1485},{"type":1021},[],{"type":18,"value":1487}," be a valid pointer to a ",{"type":13,"tag":432,"props":1489,"children":1490},{"href":471},[1491],{"type":18,"value":474},{"type":18,"value":1406},{"type":13,"tag":1494,"props":1495,"children":1497},"validity-box",{"name":1496},"Host Synchronization",[1498],{"type":13,"tag":406,"props":1499,"children":1500},{},[1501,1517],{"type":13,"tag":410,"props":1502,"children":1503},{},[1504,1506,1511,1512,1515],{"type":18,"value":1505},"Host access to ",{"type":13,"tag":34,"props":1507,"children":1509},{"className":1508},[],[1510],{"type":18,"value":1016},{"type":18,"value":1018},{"type":13,"tag":503,"props":1513,"children":1514},{"type":1021},[],{"type":18,"value":1516}," be externally synchronized",{"type":13,"tag":410,"props":1518,"children":1519},{},[1520,1521,1526,1527,1530],{"type":18,"value":1505},{"type":13,"tag":34,"props":1522,"children":1524},{"className":1523},[],[1525],{"type":18,"value":1210},{"type":18,"value":1018},{"type":13,"tag":503,"props":1528,"children":1529},{"type":1021},[],{"type":18,"value":1531}," be externally synchronized\n::",{"type":13,"tag":1533,"props":1534,"children":1535},"style",{},[1536],{"type":18,"value":1537},"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":1539},[],"markdown",1725732614037]