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