[{"data":1,"prerenderedAt":893},["ShallowReactive",2],{"i2TMrzcFzD":3},{"title":4,"description":5,"parent":6,"type":7,"xrefs":8,"body":9,"_type":892,"_id":4},"VkDeviceImageSubresourceInfoKHR","Image creation information for querying subresource layout","VK_KHR_maintenance5","structs",[],{"type":10,"children":11,"toc":890},"root",[12,28,311,393,788,884],{"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,149],{"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 VkDeviceImageSubresourceInfoKHR {\n    VkStructureType sType;\n    const void* pNext;\n    const VkImageCreateInfo* pCreateInfo;\n    const VkImageSubresource2KHR* pSubresource;\n} VkDeviceImageSubresourceInfoKHR;\n","C","c","",[41],{"type":13,"tag":21,"props":42,"children":43},{"__ignoreMap":39},[44,67,76,95,118,140],{"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}," VkDeviceImageSubresourceInfoKHR {\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,103,108,113],{"type":13,"tag":45,"props":100,"children":101},{"style":52},[102],{"type":18,"value":84},{"type":13,"tag":45,"props":104,"children":105},{"style":63},[106],{"type":18,"value":107}," VkImageCreateInfo",{"type":13,"tag":45,"props":109,"children":110},{"style":52},[111],{"type":18,"value":112},"*",{"type":13,"tag":45,"props":114,"children":115},{"style":63},[116],{"type":18,"value":117}," pCreateInfo;\n",{"type":13,"tag":45,"props":119,"children":121},{"class":47,"line":120},5,[122,126,131,135],{"type":13,"tag":45,"props":123,"children":124},{"style":52},[125],{"type":18,"value":84},{"type":13,"tag":45,"props":127,"children":128},{"style":63},[129],{"type":18,"value":130}," VkImageSubresource2KHR",{"type":13,"tag":45,"props":132,"children":133},{"style":52},[134],{"type":18,"value":112},{"type":13,"tag":45,"props":136,"children":137},{"style":63},[138],{"type":18,"value":139}," pSubresource;\n",{"type":13,"tag":45,"props":141,"children":143},{"class":47,"line":142},6,[144],{"type":13,"tag":45,"props":145,"children":146},{"style":63},[147],{"type":18,"value":148},"} VkDeviceImageSubresourceInfoKHR;\n",{"type":13,"tag":33,"props":150,"children":155},{"className":151,"code":152,"filename":153,"language":154,"meta":39,"style":39},"language-rs shiki shiki-themes github-light-default github-dark-default","pub struct DeviceImageSubresourceInfoKHR {\n    s_type: vk::StructureType,\n    p_next: *const c_void,\n    p_create_info: *const vk::ImageCreateInfo,\n    p_subresource: *const vk::ImageSubresource2KHR,\n}\n","Rust","rs",[156],{"type":13,"tag":21,"props":157,"children":158},{"__ignoreMap":39},[159,182,215,237,270,303],{"type":13,"tag":45,"props":160,"children":161},{"class":47,"line":48},[162,167,171,177],{"type":13,"tag":45,"props":163,"children":164},{"style":52},[165],{"type":18,"value":166},"pub",{"type":13,"tag":45,"props":168,"children":169},{"style":52},[170],{"type":18,"value":60},{"type":13,"tag":45,"props":172,"children":174},{"style":173},"--shiki-default:#953800;--shiki-dark:#FFA657",[175],{"type":18,"value":176}," DeviceImageSubresourceInfoKHR",{"type":13,"tag":45,"props":178,"children":179},{"style":63},[180],{"type":18,"value":181}," {\n",{"type":13,"tag":45,"props":183,"children":184},{"class":47,"line":69},[185,190,195,200,205,210],{"type":13,"tag":45,"props":186,"children":187},{"style":63},[188],{"type":18,"value":189},"    s_type",{"type":13,"tag":45,"props":191,"children":192},{"style":52},[193],{"type":18,"value":194},":",{"type":13,"tag":45,"props":196,"children":197},{"style":173},[198],{"type":18,"value":199}," vk",{"type":13,"tag":45,"props":201,"children":202},{"style":52},[203],{"type":18,"value":204},"::",{"type":13,"tag":45,"props":206,"children":207},{"style":173},[208],{"type":18,"value":209},"StructureType",{"type":13,"tag":45,"props":211,"children":212},{"style":63},[213],{"type":18,"value":214},",\n",{"type":13,"tag":45,"props":216,"children":217},{"class":47,"line":78},[218,223,227,232],{"type":13,"tag":45,"props":219,"children":220},{"style":63},[221],{"type":18,"value":222},"    p_next",{"type":13,"tag":45,"props":224,"children":225},{"style":52},[226],{"type":18,"value":194},{"type":13,"tag":45,"props":228,"children":229},{"style":52},[230],{"type":18,"value":231}," *const",{"type":13,"tag":45,"props":233,"children":234},{"style":63},[235],{"type":18,"value":236}," c_void,\n",{"type":13,"tag":45,"props":238,"children":239},{"class":47,"line":97},[240,245,249,253,257,261,266],{"type":13,"tag":45,"props":241,"children":242},{"style":63},[243],{"type":18,"value":244},"    p_create_info",{"type":13,"tag":45,"props":246,"children":247},{"style":52},[248],{"type":18,"value":194},{"type":13,"tag":45,"props":250,"children":251},{"style":52},[252],{"type":18,"value":231},{"type":13,"tag":45,"props":254,"children":255},{"style":173},[256],{"type":18,"value":199},{"type":13,"tag":45,"props":258,"children":259},{"style":52},[260],{"type":18,"value":204},{"type":13,"tag":45,"props":262,"children":263},{"style":173},[264],{"type":18,"value":265},"ImageCreateInfo",{"type":13,"tag":45,"props":267,"children":268},{"style":63},[269],{"type":18,"value":214},{"type":13,"tag":45,"props":271,"children":272},{"class":47,"line":120},[273,278,282,286,290,294,299],{"type":13,"tag":45,"props":274,"children":275},{"style":63},[276],{"type":18,"value":277},"    p_subresource",{"type":13,"tag":45,"props":279,"children":280},{"style":52},[281],{"type":18,"value":194},{"type":13,"tag":45,"props":283,"children":284},{"style":52},[285],{"type":18,"value":231},{"type":13,"tag":45,"props":287,"children":288},{"style":173},[289],{"type":18,"value":199},{"type":13,"tag":45,"props":291,"children":292},{"style":52},[293],{"type":18,"value":204},{"type":13,"tag":45,"props":295,"children":296},{"style":173},[297],{"type":18,"value":298},"ImageSubresource2KHR",{"type":13,"tag":45,"props":300,"children":301},{"style":63},[302],{"type":18,"value":214},{"type":13,"tag":45,"props":304,"children":305},{"class":47,"line":142},[306],{"type":13,"tag":45,"props":307,"children":308},{"style":63},[309],{"type":18,"value":310},"}\n",{"type":13,"tag":312,"props":313,"children":314},"ul",{},[315,336,355,374],{"type":13,"tag":316,"props":317,"children":318},"li",{},[319,325,327,334],{"type":13,"tag":21,"props":320,"children":322},{"className":321},[],[323],{"type":18,"value":324},"sType",{"type":18,"value":326}," is a ",{"type":13,"tag":328,"props":329,"children":331},"a",{"href":330},"/man/VkStructureType",[332],{"type":18,"value":333},"VkStructureType",{"type":18,"value":335}," value identifying this structure.",{"type":13,"tag":316,"props":337,"children":338},{},[339,345,347,353],{"type":13,"tag":21,"props":340,"children":342},{"className":341},[],[343],{"type":18,"value":344},"pNext",{"type":18,"value":346}," is ",{"type":13,"tag":21,"props":348,"children":350},{"className":349},[],[351],{"type":18,"value":352},"NULL",{"type":18,"value":354}," or a pointer to a structure extending this\nstructure.",{"type":13,"tag":316,"props":356,"children":357},{},[358,364,366,372],{"type":13,"tag":21,"props":359,"children":361},{"className":360},[],[362],{"type":18,"value":363},"pCreateInfo",{"type":18,"value":365}," is a pointer to a ",{"type":13,"tag":328,"props":367,"children":369},{"href":368},"/man/VkImageCreateInfo",[370],{"type":18,"value":371},"VkImageCreateInfo",{"type":18,"value":373}," structure\ncontaining parameters affecting creation of the image to query.",{"type":13,"tag":316,"props":375,"children":376},{},[377,383,385,391],{"type":13,"tag":21,"props":378,"children":380},{"className":379},[],[381],{"type":18,"value":382},"pSubresource",{"type":18,"value":384}," pSubresource is a pointer to a\n",{"type":13,"tag":328,"props":386,"children":388},{"href":387},"/man/VkImageSubresource2KHR",[389],{"type":18,"value":390},"VkImageSubresource2KHR",{"type":18,"value":392}," structure selecting a specific image\nsubresource for the query.",{"type":13,"tag":394,"props":395,"children":397},"validity-group",{"name":396},"Valid Usage",[398,429,468,505,591,635,678,728],{"type":13,"tag":399,"props":400,"children":402},"validity-field",{"name":401},"VUID-VkDeviceImageSubresourceInfoKHR-aspectMask-00997",[403],{"type":13,"tag":14,"props":404,"children":405},{},[406,407,413,415,420,422,427],{"type":18,"value":19},{"type":13,"tag":21,"props":408,"children":410},{"className":409},[],[411],{"type":18,"value":412},"aspectMask",{"type":18,"value":414}," member of ",{"type":13,"tag":21,"props":416,"children":418},{"className":417},[],[419],{"type":18,"value":382},{"type":18,"value":421}," ",{"type":13,"tag":423,"props":424,"children":426},"normative",{"type":425},"must",[],{"type":18,"value":428}," only have a\nsingle bit set",{"type":13,"tag":399,"props":430,"children":432},{"name":431},"VUID-VkDeviceImageSubresourceInfoKHR-mipLevel-01716",[433],{"type":13,"tag":14,"props":434,"children":435},{},[436,437,443,444,449,450,453,455,461,463],{"type":18,"value":19},{"type":13,"tag":21,"props":438,"children":440},{"className":439},[],[441],{"type":18,"value":442},"mipLevel",{"type":18,"value":414},{"type":13,"tag":21,"props":445,"children":447},{"className":446},[],[448],{"type":18,"value":382},{"type":18,"value":421},{"type":13,"tag":423,"props":451,"children":452},{"type":425},[],{"type":18,"value":454}," be less than the\n",{"type":13,"tag":21,"props":456,"children":458},{"className":457},[],[459],{"type":18,"value":460},"mipLevels",{"type":18,"value":462}," specified in ",{"type":13,"tag":21,"props":464,"children":466},{"className":465},[],[467],{"type":18,"value":363},{"type":13,"tag":399,"props":469,"children":471},{"name":470},"VUID-VkDeviceImageSubresourceInfoKHR-arrayLayer-01717",[472],{"type":13,"tag":14,"props":473,"children":474},{},[475,476,482,483,488,489,492,493,499,500],{"type":18,"value":19},{"type":13,"tag":21,"props":477,"children":479},{"className":478},[],[480],{"type":18,"value":481},"arrayLayer",{"type":18,"value":414},{"type":13,"tag":21,"props":484,"children":486},{"className":485},[],[487],{"type":18,"value":382},{"type":18,"value":421},{"type":13,"tag":423,"props":490,"children":491},{"type":425},[],{"type":18,"value":454},{"type":13,"tag":21,"props":494,"children":496},{"className":495},[],[497],{"type":18,"value":498},"arrayLayers",{"type":18,"value":462},{"type":13,"tag":21,"props":501,"children":503},{"className":502},[],[504],{"type":18,"value":363},{"type":13,"tag":399,"props":506,"children":508},{"name":507},"VUID-VkDeviceImageSubresourceInfoKHR-format-08886",[509],{"type":13,"tag":14,"props":510,"children":511},{},[512,514,520,522,528,530,536,538,544,545,550,552,558,560,566,568,573,574,579,580,583,585],{"type":18,"value":513},"If ",{"type":13,"tag":21,"props":515,"children":517},{"className":516},[],[518],{"type":18,"value":519},"format",{"type":18,"value":521}," of the ",{"type":13,"tag":21,"props":523,"children":525},{"className":524},[],[526],{"type":18,"value":527},"image",{"type":18,"value":529}," is a color format\nthat is not a ",{"type":13,"tag":328,"props":531,"children":533},{"href":532},"/chapters/formats#formats-requiring-sampler-ycbcr-conversion",[534],{"type":18,"value":535},"multi-planar\nimage format",{"type":18,"value":537},",\nand ",{"type":13,"tag":21,"props":539,"children":541},{"className":540},[],[542],{"type":18,"value":543},"tiling",{"type":18,"value":521},{"type":13,"tag":21,"props":546,"children":548},{"className":547},[],[549],{"type":18,"value":363},{"type":18,"value":551}," is\n",{"type":13,"tag":21,"props":553,"children":555},{"className":554},[],[556],{"type":18,"value":557},"VK_IMAGE_TILING_LINEAR",{"type":18,"value":559}," or ",{"type":13,"tag":21,"props":561,"children":563},{"className":562},[],[564],{"type":18,"value":565},"VK_IMAGE_TILING_OPTIMAL",{"type":18,"value":567},", the\n",{"type":13,"tag":21,"props":569,"children":571},{"className":570},[],[572],{"type":18,"value":412},{"type":18,"value":414},{"type":13,"tag":21,"props":575,"children":577},{"className":576},[],[578],{"type":18,"value":382},{"type":18,"value":421},{"type":13,"tag":423,"props":581,"children":582},{"type":425},[],{"type":18,"value":584}," be\n",{"type":13,"tag":21,"props":586,"children":588},{"className":587},[],[589],{"type":18,"value":590},"VK_IMAGE_ASPECT_COLOR_BIT",{"type":13,"tag":399,"props":592,"children":594},{"name":593},"VUID-VkDeviceImageSubresourceInfoKHR-format-04462",[595],{"type":13,"tag":14,"props":596,"children":597},{},[598,599,604,605,610,612,617,618,623,624,627,629],{"type":18,"value":513},{"type":13,"tag":21,"props":600,"children":602},{"className":601},[],[603],{"type":18,"value":519},{"type":18,"value":521},{"type":13,"tag":21,"props":606,"children":608},{"className":607},[],[609],{"type":18,"value":363},{"type":18,"value":611}," has a depth component, the\n",{"type":13,"tag":21,"props":613,"children":615},{"className":614},[],[616],{"type":18,"value":412},{"type":18,"value":414},{"type":13,"tag":21,"props":619,"children":621},{"className":620},[],[622],{"type":18,"value":382},{"type":18,"value":421},{"type":13,"tag":423,"props":625,"children":626},{"type":425},[],{"type":18,"value":628}," contain\n",{"type":13,"tag":21,"props":630,"children":632},{"className":631},[],[633],{"type":18,"value":634},"VK_IMAGE_ASPECT_DEPTH_BIT",{"type":13,"tag":399,"props":636,"children":638},{"name":637},"VUID-VkDeviceImageSubresourceInfoKHR-format-04463",[639],{"type":13,"tag":14,"props":640,"children":641},{},[642,643,648,649,654,656,661,662,667,668,671,672],{"type":18,"value":513},{"type":13,"tag":21,"props":644,"children":646},{"className":645},[],[647],{"type":18,"value":519},{"type":18,"value":521},{"type":13,"tag":21,"props":650,"children":652},{"className":651},[],[653],{"type":18,"value":363},{"type":18,"value":655}," has a stencil component, the\n",{"type":13,"tag":21,"props":657,"children":659},{"className":658},[],[660],{"type":18,"value":412},{"type":18,"value":414},{"type":13,"tag":21,"props":663,"children":665},{"className":664},[],[666],{"type":18,"value":382},{"type":18,"value":421},{"type":13,"tag":423,"props":669,"children":670},{"type":425},[],{"type":18,"value":628},{"type":13,"tag":21,"props":673,"children":675},{"className":674},[],[676],{"type":18,"value":677},"VK_IMAGE_ASPECT_STENCIL_BIT",{"type":13,"tag":399,"props":679,"children":681},{"name":680},"VUID-VkDeviceImageSubresourceInfoKHR-format-04464",[682],{"type":13,"tag":14,"props":683,"children":684},{},[685,686,691,692,697,699,704,705,710,711,714,716,721,723],{"type":18,"value":513},{"type":13,"tag":21,"props":687,"children":689},{"className":688},[],[690],{"type":18,"value":519},{"type":18,"value":521},{"type":13,"tag":21,"props":693,"children":695},{"className":694},[],[696],{"type":18,"value":363},{"type":18,"value":698}," does not contain a stencil or\ndepth component, the ",{"type":13,"tag":21,"props":700,"children":702},{"className":701},[],[703],{"type":18,"value":412},{"type":18,"value":414},{"type":13,"tag":21,"props":706,"children":708},{"className":707},[],[709],{"type":18,"value":382},{"type":18,"value":421},{"type":13,"tag":423,"props":712,"children":713},{"type":425},[],{"type":18,"value":715},"\nnot contain ",{"type":13,"tag":21,"props":717,"children":719},{"className":718},[],[720],{"type":18,"value":634},{"type":18,"value":722}," or\n",{"type":13,"tag":21,"props":724,"children":726},{"className":725},[],[727],{"type":18,"value":677},{"type":13,"tag":399,"props":729,"children":731},{"name":730},"VUID-VkDeviceImageSubresourceInfoKHR-tiling-08717",[732],{"type":13,"tag":14,"props":733,"children":734},{},[735,737,742,743,748,749,754,756,761,763,768,769,774,775,778,780,786],{"type":18,"value":736},"If the ",{"type":13,"tag":21,"props":738,"children":740},{"className":739},[],[741],{"type":18,"value":543},{"type":18,"value":521},{"type":13,"tag":21,"props":744,"children":746},{"className":745},[],[747],{"type":18,"value":363},{"type":18,"value":551},{"type":13,"tag":21,"props":750,"children":752},{"className":751},[],[753],{"type":18,"value":557},{"type":18,"value":755}," and has a\n",{"type":13,"tag":328,"props":757,"children":758},{"href":532},[759],{"type":18,"value":760},"multi-planar image\nformat",{"type":18,"value":762},", then the ",{"type":13,"tag":21,"props":764,"children":766},{"className":765},[],[767],{"type":18,"value":412},{"type":18,"value":414},{"type":13,"tag":21,"props":770,"children":772},{"className":771},[],[773],{"type":18,"value":382},{"type":18,"value":421},{"type":13,"tag":423,"props":776,"children":777},{"type":425},[],{"type":18,"value":779},"\nbe a single valid ",{"type":13,"tag":328,"props":781,"children":783},{"href":782},"/chapters/formats#formats-planes-image-aspect",[784],{"type":18,"value":785},"multi-planar aspect\nmask",{"type":18,"value":787}," bit",{"type":13,"tag":394,"props":789,"children":791},{"name":790},"Valid Usage (Implicit)",[792,816,838,862],{"type":13,"tag":399,"props":793,"children":795},{"name":794},"VUID-VkDeviceImageSubresourceInfoKHR-sType-sType",[796],{"type":13,"tag":14,"props":797,"children":798},{},[799,804,805,808,810],{"type":13,"tag":21,"props":800,"children":802},{"className":801},[],[803],{"type":18,"value":324},{"type":18,"value":421},{"type":13,"tag":423,"props":806,"children":807},{"type":425},[],{"type":18,"value":809}," be ",{"type":13,"tag":21,"props":811,"children":813},{"className":812},[],[814],{"type":18,"value":815},"VK_STRUCTURE_TYPE_DEVICE_IMAGE_SUBRESOURCE_INFO_KHR",{"type":13,"tag":399,"props":817,"children":819},{"name":818},"VUID-VkDeviceImageSubresourceInfoKHR-pNext-pNext",[820],{"type":13,"tag":14,"props":821,"children":822},{},[823,828,829,832,833],{"type":13,"tag":21,"props":824,"children":826},{"className":825},[],[827],{"type":18,"value":344},{"type":18,"value":421},{"type":13,"tag":423,"props":830,"children":831},{"type":425},[],{"type":18,"value":809},{"type":13,"tag":21,"props":834,"children":836},{"className":835},[],[837],{"type":18,"value":352},{"type":13,"tag":399,"props":839,"children":841},{"name":840},"VUID-VkDeviceImageSubresourceInfoKHR-pCreateInfo-parameter",[842],{"type":13,"tag":14,"props":843,"children":844},{},[845,850,851,854,856,860],{"type":13,"tag":21,"props":846,"children":848},{"className":847},[],[849],{"type":18,"value":363},{"type":18,"value":421},{"type":13,"tag":423,"props":852,"children":853},{"type":425},[],{"type":18,"value":855}," be a valid pointer to a valid ",{"type":13,"tag":328,"props":857,"children":858},{"href":368},[859],{"type":18,"value":371},{"type":18,"value":861}," structure",{"type":13,"tag":399,"props":863,"children":865},{"name":864},"VUID-VkDeviceImageSubresourceInfoKHR-pSubresource-parameter",[866],{"type":13,"tag":14,"props":867,"children":868},{},[869,874,875,878,879,883],{"type":13,"tag":21,"props":870,"children":872},{"className":871},[],[873],{"type":18,"value":382},{"type":18,"value":421},{"type":13,"tag":423,"props":876,"children":877},{"type":425},[],{"type":18,"value":855},{"type":13,"tag":328,"props":880,"children":881},{"href":387},[882],{"type":18,"value":390},{"type":18,"value":861},{"type":13,"tag":885,"props":886,"children":887},"style",{},[888],{"type":18,"value":889},"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":891},[],"markdown",1725732548814]