[{"data":1,"prerenderedAt":570},["ShallowReactive",2],{"NYCiWhvO25":3},{"title":4,"description":5,"parent":6,"type":7,"xrefs":8,"body":9,"_type":569,"_id":4},"VkMemoryMapPlacedInfoEXT","Structure containing memory map placement parameters","VK_EXT_map_memory_placed","structs",[],{"type":10,"children":11,"toc":567},"root",[12,128,140,346,418,533,561],{"type":13,"tag":14,"props":15,"children":16},"element","p",{},[17,20,27,29,35,37,43,45,51,53,59,61,66,68,73,75,81,83,88,89,95,97,103,105,111,113,118,120,126],{"type":18,"value":19},"text","If ",{"type":13,"tag":21,"props":22,"children":24},"code",{"className":23},[],[25],{"type":18,"value":26},"VK_MEMORY_MAP_PLACED_BIT_EXT",{"type":18,"value":28}," is set in\n",{"type":13,"tag":21,"props":30,"children":32},{"className":31},[],[33],{"type":18,"value":34},"VkMemoryMapInfoKHR",{"type":18,"value":36},"::",{"type":13,"tag":21,"props":38,"children":40},{"className":39},[],[41],{"type":18,"value":42},"flags",{"type":18,"value":44}," and the ",{"type":13,"tag":21,"props":46,"children":48},{"className":47},[],[49],{"type":18,"value":50},"pNext",{"type":18,"value":52}," chain of\n",{"type":13,"tag":54,"props":55,"children":57},"a",{"href":56},"/man/VkMemoryMapInfoKHR",[58],{"type":18,"value":34},{"type":18,"value":60}," includes a ",{"type":13,"tag":21,"props":62,"children":64},{"className":63},[],[65],{"type":18,"value":4},{"type":18,"value":67},"\nstructure, then that structure specifies the placement address of the memory\nmap.\nThe implementation will place the memory map at the specified address,\nreplacing any existing maps in the specified memory range.\nReplacing memory maps in this way does not implicitly unmap Vulkan memory\nobjects.\nInstead, the application ",{"type":13,"tag":69,"props":70,"children":72},"normative",{"type":71},"must",[],{"type":18,"value":74}," ensure no other Vulkan memory objects are\nmapped anywhere in the specified virtual address range.\nIf successful, ",{"type":13,"tag":21,"props":76,"children":78},{"className":77},[],[79],{"type":18,"value":80},"ppData",{"type":18,"value":82}," will be set to the same value as\n",{"type":13,"tag":21,"props":84,"children":86},{"className":85},[],[87],{"type":18,"value":4},{"type":18,"value":36},{"type":13,"tag":21,"props":90,"children":92},{"className":91},[],[93],{"type":18,"value":94},"pPlacedAddress",{"type":18,"value":96}," and\n",{"type":13,"tag":21,"props":98,"children":100},{"className":99},[],[101],{"type":18,"value":102},"vkMapMemory2KHR",{"type":18,"value":104}," will return ",{"type":13,"tag":21,"props":106,"children":108},{"className":107},[],[109],{"type":18,"value":110},"VK_SUCCESS",{"type":18,"value":112},".\nIf it cannot place the map at the requested address for any reason, the\nmemory object is left unmapped and ",{"type":13,"tag":21,"props":114,"children":116},{"className":115},[],[117],{"type":18,"value":102},{"type":18,"value":119}," will return\n",{"type":13,"tag":21,"props":121,"children":123},{"className":122},[],[124],{"type":18,"value":125},"VK_ERROR_MEMORY_MAP_FAILED",{"type":18,"value":127},".",{"type":13,"tag":14,"props":129,"children":130},{},[131,133,138],{"type":18,"value":132},"The ",{"type":13,"tag":21,"props":134,"children":136},{"className":135},[],[137],{"type":18,"value":4},{"type":18,"value":139}," structure is defined as:",{"type":13,"tag":141,"props":142,"children":143},"code-group",{},[144,230],{"type":13,"tag":145,"props":146,"children":152},"pre",{"className":147,"code":148,"filename":149,"language":150,"meta":151,"style":151},"language-c shiki shiki-themes github-light-default github-dark-default","typedef struct VkMemoryMapPlacedInfoEXT {\n VkStructureType sType;\n const void* pNext;\n void* pPlacedAddress;\n} VkMemoryMapPlacedInfoEXT;\n","C","c","",[153],{"type":13,"tag":21,"props":154,"children":155},{"__ignoreMap":151},[156,179,188,207,221],{"type":13,"tag":157,"props":158,"children":161},"span",{"class":159,"line":160},"line",1,[162,168,173],{"type":13,"tag":157,"props":163,"children":165},{"style":164},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[166],{"type":18,"value":167},"typedef",{"type":13,"tag":157,"props":169,"children":170},{"style":164},[171],{"type":18,"value":172}," struct",{"type":13,"tag":157,"props":174,"children":176},{"style":175},"--shiki-default:#1F2328;--shiki-dark:#E6EDF3",[177],{"type":18,"value":178}," VkMemoryMapPlacedInfoEXT {\n",{"type":13,"tag":157,"props":180,"children":182},{"class":159,"line":181},2,[183],{"type":13,"tag":157,"props":184,"children":185},{"style":175},[186],{"type":18,"value":187}," VkStructureType sType;\n",{"type":13,"tag":157,"props":189,"children":191},{"class":159,"line":190},3,[192,197,202],{"type":13,"tag":157,"props":193,"children":194},{"style":164},[195],{"type":18,"value":196}," const",{"type":13,"tag":157,"props":198,"children":199},{"style":164},[200],{"type":18,"value":201}," void*",{"type":13,"tag":157,"props":203,"children":204},{"style":175},[205],{"type":18,"value":206}," pNext;\n",{"type":13,"tag":157,"props":208,"children":210},{"class":159,"line":209},4,[211,216],{"type":13,"tag":157,"props":212,"children":213},{"style":164},[214],{"type":18,"value":215}," void*",{"type":13,"tag":157,"props":217,"children":218},{"style":175},[219],{"type":18,"value":220}," pPlacedAddress;\n",{"type":13,"tag":157,"props":222,"children":224},{"class":159,"line":223},5,[225],{"type":13,"tag":157,"props":226,"children":227},{"style":175},[228],{"type":18,"value":229},"} VkMemoryMapPlacedInfoEXT;\n",{"type":13,"tag":145,"props":231,"children":236},{"className":232,"code":233,"filename":234,"language":235,"meta":151,"style":151},"language-rs shiki shiki-themes github-light-default github-dark-default","pub struct MemoryMapPlacedInfoEXT {\n s_type: vk::StructureType,\n p_next: *const c_void,\n p_placed_address: *mut c_void,\n}\n","Rust","rs",[237],{"type":13,"tag":21,"props":238,"children":239},{"__ignoreMap":151},[240,263,295,317,338],{"type":13,"tag":157,"props":241,"children":242},{"class":159,"line":160},[243,248,252,258],{"type":13,"tag":157,"props":244,"children":245},{"style":164},[246],{"type":18,"value":247},"pub",{"type":13,"tag":157,"props":249,"children":250},{"style":164},[251],{"type":18,"value":172},{"type":13,"tag":157,"props":253,"children":255},{"style":254},"--shiki-default:#953800;--shiki-dark:#FFA657",[256],{"type":18,"value":257}," MemoryMapPlacedInfoEXT",{"type":13,"tag":157,"props":259,"children":260},{"style":175},[261],{"type":18,"value":262}," {\n",{"type":13,"tag":157,"props":264,"children":265},{"class":159,"line":181},[266,271,276,281,285,290],{"type":13,"tag":157,"props":267,"children":268},{"style":175},[269],{"type":18,"value":270}," s_type",{"type":13,"tag":157,"props":272,"children":273},{"style":164},[274],{"type":18,"value":275},":",{"type":13,"tag":157,"props":277,"children":278},{"style":254},[279],{"type":18,"value":280}," vk",{"type":13,"tag":157,"props":282,"children":283},{"style":164},[284],{"type":18,"value":36},{"type":13,"tag":157,"props":286,"children":287},{"style":254},[288],{"type":18,"value":289},"StructureType",{"type":13,"tag":157,"props":291,"children":292},{"style":175},[293],{"type":18,"value":294},",\n",{"type":13,"tag":157,"props":296,"children":297},{"class":159,"line":190},[298,303,307,312],{"type":13,"tag":157,"props":299,"children":300},{"style":175},[301],{"type":18,"value":302}," p_next",{"type":13,"tag":157,"props":304,"children":305},{"style":164},[306],{"type":18,"value":275},{"type":13,"tag":157,"props":308,"children":309},{"style":164},[310],{"type":18,"value":311}," *const",{"type":13,"tag":157,"props":313,"children":314},{"style":175},[315],{"type":18,"value":316}," c_void,\n",{"type":13,"tag":157,"props":318,"children":319},{"class":159,"line":209},[320,325,329,334],{"type":13,"tag":157,"props":321,"children":322},{"style":175},[323],{"type":18,"value":324}," p_placed_address",{"type":13,"tag":157,"props":326,"children":327},{"style":164},[328],{"type":18,"value":275},{"type":13,"tag":157,"props":330,"children":331},{"style":164},[332],{"type":18,"value":333}," *mut",{"type":13,"tag":157,"props":335,"children":336},{"style":175},[337],{"type":18,"value":316},{"type":13,"tag":157,"props":339,"children":340},{"class":159,"line":223},[341],{"type":13,"tag":157,"props":342,"children":343},{"style":175},[344],{"type":18,"value":345},"}\n",{"type":13,"tag":347,"props":348,"children":349},"ul",{},[350,370,388],{"type":13,"tag":351,"props":352,"children":353},"li",{},[354,360,362,368],{"type":13,"tag":21,"props":355,"children":357},{"className":356},[],[358],{"type":18,"value":359},"sType",{"type":18,"value":361}," is a ",{"type":13,"tag":54,"props":363,"children":365},{"href":364},"/man/VkStructureType",[366],{"type":18,"value":367},"VkStructureType",{"type":18,"value":369}," value identifying this structure.",{"type":13,"tag":351,"props":371,"children":372},{},[373,378,380,386],{"type":13,"tag":21,"props":374,"children":376},{"className":375},[],[377],{"type":18,"value":50},{"type":18,"value":379}," is ",{"type":13,"tag":21,"props":381,"children":383},{"className":382},[],[384],{"type":18,"value":385},"NULL",{"type":18,"value":387}," or a pointer to a structure extending this\nstructure.",{"type":13,"tag":351,"props":389,"children":390},{},[391,396,398,403,404,409,411,416],{"type":13,"tag":21,"props":392,"children":394},{"className":393},[],[395],{"type":18,"value":94},{"type":18,"value":397}," is the virtual address at which to place the\naddress.\nIf ",{"type":13,"tag":21,"props":399,"children":401},{"className":400},[],[402],{"type":18,"value":34},{"type":18,"value":36},{"type":13,"tag":21,"props":405,"children":407},{"className":406},[],[408],{"type":18,"value":42},{"type":18,"value":410}," does not contain\n",{"type":13,"tag":21,"props":412,"children":414},{"className":413},[],[415],{"type":18,"value":26},{"type":18,"value":417},", this value is ignored.",{"type":13,"tag":419,"props":420,"children":422},"validity-group",{"name":421},"Valid Usage",[423,469,500],{"type":13,"tag":424,"props":425,"children":427},"validity-field",{"name":426},"VUID-VkMemoryMapPlacedInfoEXT-flags-09576",[428],{"type":13,"tag":14,"props":429,"children":430},{},[431,432,437,438,443,445,450,452,457,459,462,464],{"type":18,"value":19},{"type":13,"tag":21,"props":433,"children":435},{"className":434},[],[436],{"type":18,"value":34},{"type":18,"value":36},{"type":13,"tag":21,"props":439,"children":441},{"className":440},[],[442],{"type":18,"value":42},{"type":18,"value":444}," contains\n",{"type":13,"tag":21,"props":446,"children":448},{"className":447},[],[449],{"type":18,"value":26},{"type":18,"value":451},", ",{"type":13,"tag":21,"props":453,"children":455},{"className":454},[],[456],{"type":18,"value":94},{"type":18,"value":458}," ",{"type":13,"tag":69,"props":460,"children":461},{"type":71},[],{"type":18,"value":463}," not be\n",{"type":13,"tag":21,"props":465,"children":467},{"className":466},[],[468],{"type":18,"value":385},{"type":13,"tag":424,"props":470,"children":472},{"name":471},"VUID-VkMemoryMapPlacedInfoEXT-pPlacedAddress-09577",[473],{"type":13,"tag":14,"props":474,"children":475},{},[476,481,482,485,487,493,494],{"type":13,"tag":21,"props":477,"children":479},{"className":478},[],[480],{"type":18,"value":94},{"type":18,"value":458},{"type":13,"tag":69,"props":483,"children":484},{"type":71},[],{"type":18,"value":486}," be aligned to an integer multiple of\n",{"type":13,"tag":21,"props":488,"children":490},{"className":489},[],[491],{"type":18,"value":492},"VkPhysicalDeviceMapMemoryPlacedPropertiesEXT",{"type":18,"value":36},{"type":13,"tag":21,"props":495,"children":497},{"className":496},[],[498],{"type":18,"value":499},"minPlacedMemoryMapAlignment",{"type":13,"tag":424,"props":501,"children":503},{"name":502},"VUID-VkMemoryMapPlacedInfoEXT-pPlacedAddress-09578",[504],{"type":13,"tag":14,"props":505,"children":506},{},[507,509,514,515,520,521,527,528,531],{"type":18,"value":508},"The address range specified by ",{"type":13,"tag":21,"props":510,"children":512},{"className":511},[],[513],{"type":18,"value":94},{"type":18,"value":96},{"type":13,"tag":21,"props":516,"children":518},{"className":517},[],[519],{"type":18,"value":34},{"type":18,"value":36},{"type":13,"tag":21,"props":522,"children":524},{"className":523},[],[525],{"type":18,"value":526},"size",{"type":18,"value":458},{"type":13,"tag":69,"props":529,"children":530},{"type":71},[],{"type":18,"value":532}," not overlap any existing\nVulkan memory object mapping",{"type":13,"tag":419,"props":534,"children":536},{"name":535},"Valid Usage (Implicit)",[537],{"type":13,"tag":424,"props":538,"children":540},{"name":539},"VUID-VkMemoryMapPlacedInfoEXT-sType-sType",[541],{"type":13,"tag":14,"props":542,"children":543},{},[544,549,550,553,555],{"type":13,"tag":21,"props":545,"children":547},{"className":546},[],[548],{"type":18,"value":359},{"type":18,"value":458},{"type":13,"tag":69,"props":551,"children":552},{"type":71},[],{"type":18,"value":554}," be ",{"type":13,"tag":21,"props":556,"children":558},{"className":557},[],[559],{"type":18,"value":560},"VK_STRUCTURE_TYPE_MEMORY_MAP_PLACED_INFO_EXT",{"type":13,"tag":562,"props":563,"children":564},"style",{},[565],{"type":18,"value":566},"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":151,"searchDepth":181,"depth":181,"links":568},[],"markdown",1725732562616]