[{"data":1,"prerenderedAt":657},["ShallowReactive",2],{"EIq4NWtBYZ":3},{"title":4,"description":5,"parent":6,"type":7,"xrefs":8,"body":9,"_type":656,"_id":4},"vkBindImageMemory2","Bind device memory to image objects","VK_VERSION_1_1","protos",[],{"type":10,"children":11,"toc":654},"root",[12,20,298,351,363,398,430,487,563,648],{"type":13,"tag":14,"props":15,"children":16},"element","p",{},[17],{"type":18,"value":19},"text","To attach memory to image objects for one or more images at a time, call:",{"type":13,"tag":21,"props":22,"children":23},"code-group",{},[24,128],{"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 vkBindImageMemory2KHR(\n    VkDevice device,\n    uint32_t bindInfoCount,\n    const VkBindImageMemoryInfo* pBindInfos);\n","C","c","",[33],{"type":13,"tag":34,"props":35,"children":36},"code",{"__ignoreMap":31},[37,60,80,99],{"type":13,"tag":38,"props":39,"children":42},"span",{"class":40,"line":41},"line",1,[43,49,55],{"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":54},"vkBindImageMemory2KHR",{"type":13,"tag":38,"props":56,"children":57},{"style":45},[58],{"type":18,"value":59},"(\n",{"type":13,"tag":38,"props":61,"children":63},{"class":40,"line":62},2,[64,69,75],{"type":13,"tag":38,"props":65,"children":66},{"style":45},[67],{"type":18,"value":68},"    VkDevice ",{"type":13,"tag":38,"props":70,"children":72},{"style":71},"--shiki-default:#953800;--shiki-dark:#FFA657",[73],{"type":18,"value":74},"device",{"type":13,"tag":38,"props":76,"children":77},{"style":45},[78],{"type":18,"value":79},",\n",{"type":13,"tag":38,"props":81,"children":83},{"class":40,"line":82},3,[84,90,95],{"type":13,"tag":38,"props":85,"children":87},{"style":86},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[88],{"type":18,"value":89},"    uint32_t",{"type":13,"tag":38,"props":91,"children":92},{"style":71},[93],{"type":18,"value":94}," bindInfoCount",{"type":13,"tag":38,"props":96,"children":97},{"style":45},[98],{"type":18,"value":79},{"type":13,"tag":38,"props":100,"children":102},{"class":40,"line":101},4,[103,108,113,118,123],{"type":13,"tag":38,"props":104,"children":105},{"style":86},[106],{"type":18,"value":107},"    const",{"type":13,"tag":38,"props":109,"children":110},{"style":45},[111],{"type":18,"value":112}," VkBindImageMemoryInfo",{"type":13,"tag":38,"props":114,"children":115},{"style":86},[116],{"type":18,"value":117},"*",{"type":13,"tag":38,"props":119,"children":120},{"style":71},[121],{"type":18,"value":122}," pBindInfos",{"type":13,"tag":38,"props":124,"children":125},{"style":45},[126],{"type":18,"value":127},");\n",{"type":13,"tag":25,"props":129,"children":134},{"className":130,"code":131,"filename":132,"language":133,"meta":31,"style":31},"language-rs shiki shiki-themes github-light-default github-dark-default","pub fn bind_image_memory2_khr(\n    device: crate :: vk :: vk::Device,\n    bind_info_count: u32,\n    p_bind_infos: *const vk::BindImageMemoryInfo,\n) -> vk::Result;\n","Rust","rs",[135],{"type":13,"tag":34,"props":136,"children":137},{"__ignoreMap":31},[138,160,211,232,266],{"type":13,"tag":38,"props":139,"children":140},{"class":40,"line":41},[141,146,151,156],{"type":13,"tag":38,"props":142,"children":143},{"style":86},[144],{"type":18,"value":145},"pub",{"type":13,"tag":38,"props":147,"children":148},{"style":86},[149],{"type":18,"value":150}," fn",{"type":13,"tag":38,"props":152,"children":153},{"style":51},[154],{"type":18,"value":155}," bind_image_memory2_khr",{"type":13,"tag":38,"props":157,"children":158},{"style":45},[159],{"type":18,"value":59},{"type":13,"tag":38,"props":161,"children":162},{"class":40,"line":62},[163,168,173,178,183,188,193,198,202,207],{"type":13,"tag":38,"props":164,"children":165},{"style":45},[166],{"type":18,"value":167},"    device",{"type":13,"tag":38,"props":169,"children":170},{"style":86},[171],{"type":18,"value":172},":",{"type":13,"tag":38,"props":174,"children":175},{"style":86},[176],{"type":18,"value":177}," crate",{"type":13,"tag":38,"props":179,"children":180},{"style":86},[181],{"type":18,"value":182}," ::",{"type":13,"tag":38,"props":184,"children":185},{"style":45},[186],{"type":18,"value":187}," vk ",{"type":13,"tag":38,"props":189,"children":190},{"style":86},[191],{"type":18,"value":192},"::",{"type":13,"tag":38,"props":194,"children":195},{"style":71},[196],{"type":18,"value":197}," vk",{"type":13,"tag":38,"props":199,"children":200},{"style":86},[201],{"type":18,"value":192},{"type":13,"tag":38,"props":203,"children":204},{"style":71},[205],{"type":18,"value":206},"Device",{"type":13,"tag":38,"props":208,"children":209},{"style":45},[210],{"type":18,"value":79},{"type":13,"tag":38,"props":212,"children":213},{"class":40,"line":82},[214,219,223,228],{"type":13,"tag":38,"props":215,"children":216},{"style":45},[217],{"type":18,"value":218},"    bind_info_count",{"type":13,"tag":38,"props":220,"children":221},{"style":86},[222],{"type":18,"value":172},{"type":13,"tag":38,"props":224,"children":225},{"style":71},[226],{"type":18,"value":227}," u32",{"type":13,"tag":38,"props":229,"children":230},{"style":45},[231],{"type":18,"value":79},{"type":13,"tag":38,"props":233,"children":234},{"class":40,"line":101},[235,240,244,249,253,257,262],{"type":13,"tag":38,"props":236,"children":237},{"style":45},[238],{"type":18,"value":239},"    p_bind_infos",{"type":13,"tag":38,"props":241,"children":242},{"style":86},[243],{"type":18,"value":172},{"type":13,"tag":38,"props":245,"children":246},{"style":86},[247],{"type":18,"value":248}," *const",{"type":13,"tag":38,"props":250,"children":251},{"style":71},[252],{"type":18,"value":197},{"type":13,"tag":38,"props":254,"children":255},{"style":86},[256],{"type":18,"value":192},{"type":13,"tag":38,"props":258,"children":259},{"style":71},[260],{"type":18,"value":261},"BindImageMemoryInfo",{"type":13,"tag":38,"props":263,"children":264},{"style":45},[265],{"type":18,"value":79},{"type":13,"tag":38,"props":267,"children":269},{"class":40,"line":268},5,[270,275,280,284,288,293],{"type":13,"tag":38,"props":271,"children":272},{"style":45},[273],{"type":18,"value":274},") ",{"type":13,"tag":38,"props":276,"children":277},{"style":86},[278],{"type":18,"value":279},"->",{"type":13,"tag":38,"props":281,"children":282},{"style":71},[283],{"type":18,"value":197},{"type":13,"tag":38,"props":285,"children":286},{"style":86},[287],{"type":18,"value":192},{"type":13,"tag":38,"props":289,"children":290},{"style":71},[291],{"type":18,"value":292},"Result",{"type":13,"tag":38,"props":294,"children":295},{"style":45},[296],{"type":18,"value":297},";\n",{"type":13,"tag":299,"props":300,"children":301},"ul",{},[302,313,332],{"type":13,"tag":303,"props":304,"children":305},"li",{},[306,311],{"type":13,"tag":34,"props":307,"children":309},{"className":308},[],[310],{"type":18,"value":74},{"type":18,"value":312}," is the logical device that owns the images and memory.",{"type":13,"tag":303,"props":314,"children":315},{},[316,322,324,330],{"type":13,"tag":34,"props":317,"children":319},{"className":318},[],[320],{"type":18,"value":321},"bindInfoCount",{"type":18,"value":323}," is the number of elements in ",{"type":13,"tag":34,"props":325,"children":327},{"className":326},[],[328],{"type":18,"value":329},"pBindInfos",{"type":18,"value":331},".",{"type":13,"tag":303,"props":333,"children":334},{},[335,340,342,349],{"type":13,"tag":34,"props":336,"children":338},{"className":337},[],[339],{"type":18,"value":329},{"type":18,"value":341}," is a pointer to an array of ",{"type":13,"tag":343,"props":344,"children":346},"a",{"href":345},"/man/VkBindImageMemoryInfo",[347],{"type":18,"value":348},"VkBindImageMemoryInfo",{"type":18,"value":350},"\nstructures, describing images and memory to bind.",{"type":13,"tag":14,"props":352,"children":353},{},[354,356,361],{"type":18,"value":355},"On some implementations, it ",{"type":13,"tag":357,"props":358,"children":360},"normative",{"type":359},"may",[],{"type":18,"value":362}," be more efficient to batch memory bindings\ninto a single command.",{"type":13,"tag":14,"props":364,"children":365},{},[366,368,378,380,384,386,391,393,396],{"type":18,"value":367},"If the ",{"type":13,"tag":343,"props":369,"children":371},{"href":370},"/man/VkPhysicalDeviceMaintenance6FeaturesKHR#features-maintenance6",[372],{"type":13,"tag":34,"props":373,"children":375},{"className":374},[],[376],{"type":18,"value":377},"maintenance6",{"type":18,"value":379}," feature is enabled,\nthis command ",{"type":13,"tag":357,"props":381,"children":383},{"type":382},"must",[],{"type":18,"value":385}," attempt to perform all of the memory binding operations\ndescribed by ",{"type":13,"tag":34,"props":387,"children":389},{"className":388},[],[390],{"type":18,"value":329},{"type":18,"value":392},", and ",{"type":13,"tag":357,"props":394,"children":395},{"type":382},[],{"type":18,"value":397}," not early exit on the first\nfailure.",{"type":13,"tag":14,"props":399,"children":400},{},[401,403,408,410,416,418,421,423,429],{"type":18,"value":402},"If any of the memory binding operations described by ",{"type":13,"tag":34,"props":404,"children":406},{"className":405},[],[407],{"type":18,"value":329},{"type":18,"value":409}," fail,\nthe ",{"type":13,"tag":343,"props":411,"children":413},{"href":412},"/man/VkResult",[414],{"type":18,"value":415},"VkResult",{"type":18,"value":417}," returned by this command ",{"type":13,"tag":357,"props":419,"children":420},{"type":382},[],{"type":18,"value":422}," be the return value of any\none of the memory binding operations which did not return ",{"type":13,"tag":34,"props":424,"children":426},{"className":425},[],[427],{"type":18,"value":428},"VK_SUCCESS",{"type":18,"value":331},{"type":13,"tag":431,"props":432,"children":433},"note",{},[434,482],{"type":13,"tag":14,"props":435,"children":436},{},[437,438,443,445,451,453,459,461,466,468,473,475,480],{"type":18,"value":367},{"type":13,"tag":34,"props":439,"children":441},{"className":440},[],[442],{"type":18,"value":4},{"type":18,"value":444}," command failed,\n",{"type":13,"tag":343,"props":446,"children":448},{"href":447},"/man/VkBindMemoryStatusKHR",[449],{"type":18,"value":450},"VkBindMemoryStatusKHR",{"type":18,"value":452}," structures were not included in the ",{"type":13,"tag":34,"props":454,"children":456},{"className":455},[],[457],{"type":18,"value":458},"pNext",{"type":18,"value":460},"\nchains of each element of ",{"type":13,"tag":34,"props":462,"children":464},{"className":463},[],[465],{"type":18,"value":329},{"type":18,"value":467},",\nand ",{"type":13,"tag":34,"props":469,"children":471},{"className":470},[],[472],{"type":18,"value":321},{"type":18,"value":474}," was greater than one, then the images referenced by\n",{"type":13,"tag":34,"props":476,"children":478},{"className":477},[],[479],{"type":18,"value":329},{"type":18,"value":481}," will be in an indeterminate state, and must not be used.",{"type":13,"tag":14,"props":483,"children":484},{},[485],{"type":18,"value":486},"Applications should destroy these images.",{"type":13,"tag":488,"props":489,"children":491},"validity-group",{"name":490},"Valid Usage",[492,545],{"type":13,"tag":493,"props":494,"children":496},"validity-field",{"name":495},"VUID-vkBindImageMemory2-pBindInfos-02858",[497],{"type":13,"tag":14,"props":498,"children":499},{},[500,502,506,507,513,515,521,523,527,528,533,535,538,540],{"type":18,"value":501},"If any ",{"type":13,"tag":343,"props":503,"children":504},{"href":345},[505],{"type":18,"value":348},{"type":18,"value":192},{"type":13,"tag":34,"props":508,"children":510},{"className":509},[],[511],{"type":18,"value":512},"image",{"type":18,"value":514}," was created with\n",{"type":13,"tag":34,"props":516,"children":518},{"className":517},[],[519],{"type":18,"value":520},"VK_IMAGE_CREATE_DISJOINT_BIT",{"type":18,"value":522}," then all planes of\n",{"type":13,"tag":343,"props":524,"children":525},{"href":345},[526],{"type":18,"value":348},{"type":18,"value":192},{"type":13,"tag":34,"props":529,"children":531},{"className":530},[],[532],{"type":18,"value":512},{"type":18,"value":534}," ",{"type":13,"tag":357,"props":536,"children":537},{"type":382},[],{"type":18,"value":539}," be bound individually in\nseparate ",{"type":13,"tag":34,"props":541,"children":543},{"className":542},[],[544],{"type":18,"value":329},{"type":13,"tag":493,"props":546,"children":548},{"name":547},"VUID-vkBindImageMemory2-pBindInfos-04006",[549],{"type":13,"tag":14,"props":550,"children":551},{},[552,557,558,561],{"type":13,"tag":34,"props":553,"children":555},{"className":554},[],[556],{"type":18,"value":329},{"type":18,"value":534},{"type":13,"tag":357,"props":559,"children":560},{"type":382},[],{"type":18,"value":562}," not refer to the same image subresource more than\nonce",{"type":13,"tag":488,"props":564,"children":566},{"name":565},"Valid Usage (Implicit)",[567,593,624],{"type":13,"tag":493,"props":568,"children":570},{"name":569},"VUID-vkBindImageMemory2-device-parameter",[571],{"type":13,"tag":14,"props":572,"children":573},{},[574,579,580,583,585,591],{"type":13,"tag":34,"props":575,"children":577},{"className":576},[],[578],{"type":18,"value":74},{"type":18,"value":534},{"type":13,"tag":357,"props":581,"children":582},{"type":382},[],{"type":18,"value":584}," be a valid ",{"type":13,"tag":343,"props":586,"children":588},{"href":587},"/man/VkDevice",[589],{"type":18,"value":590},"VkDevice",{"type":18,"value":592}," handle",{"type":13,"tag":493,"props":594,"children":596},{"name":595},"VUID-vkBindImageMemory2-pBindInfos-parameter",[597],{"type":13,"tag":14,"props":598,"children":599},{},[600,605,606,609,611,616,618,622],{"type":13,"tag":34,"props":601,"children":603},{"className":602},[],[604],{"type":18,"value":329},{"type":18,"value":534},{"type":13,"tag":357,"props":607,"children":608},{"type":382},[],{"type":18,"value":610}," be a valid pointer to an array of ",{"type":13,"tag":34,"props":612,"children":614},{"className":613},[],[615],{"type":18,"value":321},{"type":18,"value":617}," valid ",{"type":13,"tag":343,"props":619,"children":620},{"href":345},[621],{"type":18,"value":348},{"type":18,"value":623}," structures",{"type":13,"tag":493,"props":625,"children":627},{"name":626},"VUID-vkBindImageMemory2-bindInfoCount-arraylength",[628],{"type":13,"tag":14,"props":629,"children":630},{},[631,636,637,640,642],{"type":13,"tag":34,"props":632,"children":634},{"className":633},[],[635],{"type":18,"value":321},{"type":18,"value":534},{"type":13,"tag":357,"props":638,"children":639},{"type":382},[],{"type":18,"value":641}," be greater than ",{"type":13,"tag":34,"props":643,"children":645},{"className":644},[],[646],{"type":18,"value":647},"0",{"type":13,"tag":649,"props":650,"children":651},"style",{},[652],{"type":18,"value":653},"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":62,"depth":62,"links":655},[],"markdown",1725732597040]