[{"data":1,"prerenderedAt":735},["ShallowReactive",2],{"2mlHhcfwn5":3},{"title":4,"description":5,"parent":6,"type":7,"xrefs":8,"body":9,"_type":734,"_id":4},"VkDeviceGroupDeviceCreateInfo","Create a logical device from multiple physical devices","VK_VERSION_1_1","structs",[],{"type":10,"children":11,"toc":732},"root",[12,59,322,327,392,463,503,552,651,726],{"type":13,"tag":14,"props":15,"children":16},"element","p",{},[17,20,25,27,33,35,41,43,50,52,57],{"type":18,"value":19},"text","A logical device ",{"type":13,"tag":21,"props":22,"children":24},"normative",{"type":23},"can",[],{"type":18,"value":26}," be created that connects to one or more physical\ndevices by adding a ",{"type":13,"tag":28,"props":29,"children":31},"code",{"className":30},[],[32],{"type":18,"value":4},{"type":18,"value":34}," structure to the\n",{"type":13,"tag":28,"props":36,"children":38},{"className":37},[],[39],{"type":18,"value":40},"pNext",{"type":18,"value":42}," chain of ",{"type":13,"tag":44,"props":45,"children":47},"a",{"href":46},"/man/VkDeviceCreateInfo",[48],{"type":18,"value":49},"VkDeviceCreateInfo",{"type":18,"value":51},".\nThe ",{"type":13,"tag":28,"props":53,"children":55},{"className":54},[],[56],{"type":18,"value":4},{"type":18,"value":58}," structure is defined as:",{"type":13,"tag":60,"props":61,"children":62},"code-group",{},[63,172],{"type":13,"tag":64,"props":65,"children":71},"pre",{"className":66,"code":67,"filename":68,"language":69,"meta":70,"style":70},"language-c shiki shiki-themes github-light-default github-dark-default","typedef struct VkDeviceGroupDeviceCreateInfo {\n    VkStructureType sType;\n    const void* pNext;\n    uint32_t physicalDeviceCount;\n    const VkPhysicalDevice* pPhysicalDevices;\n} VkDeviceGroupDeviceCreateInfo;\n","C","c","",[72],{"type":13,"tag":28,"props":73,"children":74},{"__ignoreMap":70},[75,98,107,126,140,163],{"type":13,"tag":76,"props":77,"children":80},"span",{"class":78,"line":79},"line",1,[81,87,92],{"type":13,"tag":76,"props":82,"children":84},{"style":83},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[85],{"type":18,"value":86},"typedef",{"type":13,"tag":76,"props":88,"children":89},{"style":83},[90],{"type":18,"value":91}," struct",{"type":13,"tag":76,"props":93,"children":95},{"style":94},"--shiki-default:#1F2328;--shiki-dark:#E6EDF3",[96],{"type":18,"value":97}," VkDeviceGroupDeviceCreateInfo {\n",{"type":13,"tag":76,"props":99,"children":101},{"class":78,"line":100},2,[102],{"type":13,"tag":76,"props":103,"children":104},{"style":94},[105],{"type":18,"value":106},"    VkStructureType sType;\n",{"type":13,"tag":76,"props":108,"children":110},{"class":78,"line":109},3,[111,116,121],{"type":13,"tag":76,"props":112,"children":113},{"style":83},[114],{"type":18,"value":115},"    const",{"type":13,"tag":76,"props":117,"children":118},{"style":83},[119],{"type":18,"value":120}," void*",{"type":13,"tag":76,"props":122,"children":123},{"style":94},[124],{"type":18,"value":125}," pNext;\n",{"type":13,"tag":76,"props":127,"children":129},{"class":78,"line":128},4,[130,135],{"type":13,"tag":76,"props":131,"children":132},{"style":83},[133],{"type":18,"value":134},"    uint32_t",{"type":13,"tag":76,"props":136,"children":137},{"style":94},[138],{"type":18,"value":139}," physicalDeviceCount;\n",{"type":13,"tag":76,"props":141,"children":143},{"class":78,"line":142},5,[144,148,153,158],{"type":13,"tag":76,"props":145,"children":146},{"style":83},[147],{"type":18,"value":115},{"type":13,"tag":76,"props":149,"children":150},{"style":94},[151],{"type":18,"value":152}," VkPhysicalDevice",{"type":13,"tag":76,"props":154,"children":155},{"style":83},[156],{"type":18,"value":157},"*",{"type":13,"tag":76,"props":159,"children":160},{"style":94},[161],{"type":18,"value":162}," pPhysicalDevices;\n",{"type":13,"tag":76,"props":164,"children":166},{"class":78,"line":165},6,[167],{"type":13,"tag":76,"props":168,"children":169},{"style":94},[170],{"type":18,"value":171},"} VkDeviceGroupDeviceCreateInfo;\n",{"type":13,"tag":64,"props":173,"children":178},{"className":174,"code":175,"filename":176,"language":177,"meta":70,"style":70},"language-rs shiki shiki-themes github-light-default github-dark-default","pub struct DeviceGroupDeviceCreateInfo {\n    s_type: vk::StructureType,\n    p_next: *const c_void,\n    physical_device_count: u32,\n    p_physical_devices: *const vk::PhysicalDevice,\n}\n","Rust","rs",[179],{"type":13,"tag":28,"props":180,"children":181},{"__ignoreMap":70},[182,205,238,260,281,314],{"type":13,"tag":76,"props":183,"children":184},{"class":78,"line":79},[185,190,194,200],{"type":13,"tag":76,"props":186,"children":187},{"style":83},[188],{"type":18,"value":189},"pub",{"type":13,"tag":76,"props":191,"children":192},{"style":83},[193],{"type":18,"value":91},{"type":13,"tag":76,"props":195,"children":197},{"style":196},"--shiki-default:#953800;--shiki-dark:#FFA657",[198],{"type":18,"value":199}," DeviceGroupDeviceCreateInfo",{"type":13,"tag":76,"props":201,"children":202},{"style":94},[203],{"type":18,"value":204}," {\n",{"type":13,"tag":76,"props":206,"children":207},{"class":78,"line":100},[208,213,218,223,228,233],{"type":13,"tag":76,"props":209,"children":210},{"style":94},[211],{"type":18,"value":212},"    s_type",{"type":13,"tag":76,"props":214,"children":215},{"style":83},[216],{"type":18,"value":217},":",{"type":13,"tag":76,"props":219,"children":220},{"style":196},[221],{"type":18,"value":222}," vk",{"type":13,"tag":76,"props":224,"children":225},{"style":83},[226],{"type":18,"value":227},"::",{"type":13,"tag":76,"props":229,"children":230},{"style":196},[231],{"type":18,"value":232},"StructureType",{"type":13,"tag":76,"props":234,"children":235},{"style":94},[236],{"type":18,"value":237},",\n",{"type":13,"tag":76,"props":239,"children":240},{"class":78,"line":109},[241,246,250,255],{"type":13,"tag":76,"props":242,"children":243},{"style":94},[244],{"type":18,"value":245},"    p_next",{"type":13,"tag":76,"props":247,"children":248},{"style":83},[249],{"type":18,"value":217},{"type":13,"tag":76,"props":251,"children":252},{"style":83},[253],{"type":18,"value":254}," *const",{"type":13,"tag":76,"props":256,"children":257},{"style":94},[258],{"type":18,"value":259}," c_void,\n",{"type":13,"tag":76,"props":261,"children":262},{"class":78,"line":128},[263,268,272,277],{"type":13,"tag":76,"props":264,"children":265},{"style":94},[266],{"type":18,"value":267},"    physical_device_count",{"type":13,"tag":76,"props":269,"children":270},{"style":83},[271],{"type":18,"value":217},{"type":13,"tag":76,"props":273,"children":274},{"style":196},[275],{"type":18,"value":276}," u32",{"type":13,"tag":76,"props":278,"children":279},{"style":94},[280],{"type":18,"value":237},{"type":13,"tag":76,"props":282,"children":283},{"class":78,"line":142},[284,289,293,297,301,305,310],{"type":13,"tag":76,"props":285,"children":286},{"style":94},[287],{"type":18,"value":288},"    p_physical_devices",{"type":13,"tag":76,"props":290,"children":291},{"style":83},[292],{"type":18,"value":217},{"type":13,"tag":76,"props":294,"children":295},{"style":83},[296],{"type":18,"value":254},{"type":13,"tag":76,"props":298,"children":299},{"style":196},[300],{"type":18,"value":222},{"type":13,"tag":76,"props":302,"children":303},{"style":83},[304],{"type":18,"value":227},{"type":13,"tag":76,"props":306,"children":307},{"style":196},[308],{"type":18,"value":309},"PhysicalDevice",{"type":13,"tag":76,"props":311,"children":312},{"style":94},[313],{"type":18,"value":237},{"type":13,"tag":76,"props":315,"children":316},{"class":78,"line":165},[317],{"type":13,"tag":76,"props":318,"children":319},{"style":94},[320],{"type":18,"value":321},"}\n",{"type":13,"tag":14,"props":323,"children":324},{},[325],{"type":18,"value":326},"or the equivalent",{"type":13,"tag":60,"props":328,"children":329},{},[330,349],{"type":13,"tag":64,"props":331,"children":333},{"className":66,"code":332,"filename":68,"language":69,"meta":70,"style":70},"typedef VkDeviceGroupDeviceCreateInfo VkDeviceGroupDeviceCreateInfoKHR;\n",[334],{"type":13,"tag":28,"props":335,"children":336},{"__ignoreMap":70},[337],{"type":13,"tag":76,"props":338,"children":339},{"class":78,"line":79},[340,344],{"type":13,"tag":76,"props":341,"children":342},{"style":83},[343],{"type":18,"value":86},{"type":13,"tag":76,"props":345,"children":346},{"style":94},[347],{"type":18,"value":348}," VkDeviceGroupDeviceCreateInfo VkDeviceGroupDeviceCreateInfoKHR;\n",{"type":13,"tag":64,"props":350,"children":352},{"className":174,"code":351,"filename":176,"language":177,"meta":70,"style":70},"type DeviceGroupDeviceCreateInfoKHR = vk::DeviceGroupDeviceCreateInfo;\n",[353],{"type":13,"tag":28,"props":354,"children":355},{"__ignoreMap":70},[356],{"type":13,"tag":76,"props":357,"children":358},{"class":78,"line":79},[359,364,369,374,378,382,387],{"type":13,"tag":76,"props":360,"children":361},{"style":83},[362],{"type":18,"value":363},"type",{"type":13,"tag":76,"props":365,"children":366},{"style":196},[367],{"type":18,"value":368}," DeviceGroupDeviceCreateInfoKHR",{"type":13,"tag":76,"props":370,"children":371},{"style":83},[372],{"type":18,"value":373}," =",{"type":13,"tag":76,"props":375,"children":376},{"style":196},[377],{"type":18,"value":222},{"type":13,"tag":76,"props":379,"children":380},{"style":83},[381],{"type":18,"value":227},{"type":13,"tag":76,"props":383,"children":384},{"style":196},[385],{"type":18,"value":386},"DeviceGroupDeviceCreateInfo",{"type":13,"tag":76,"props":388,"children":389},{"style":94},[390],{"type":18,"value":391},";\n",{"type":13,"tag":393,"props":394,"children":395},"ul",{},[396,416,434,453],{"type":13,"tag":397,"props":398,"children":399},"li",{},[400,406,408,414],{"type":13,"tag":28,"props":401,"children":403},{"className":402},[],[404],{"type":18,"value":405},"sType",{"type":18,"value":407}," is a ",{"type":13,"tag":44,"props":409,"children":411},{"href":410},"/man/VkStructureType",[412],{"type":18,"value":413},"VkStructureType",{"type":18,"value":415}," value identifying this structure.",{"type":13,"tag":397,"props":417,"children":418},{},[419,424,426,432],{"type":13,"tag":28,"props":420,"children":422},{"className":421},[],[423],{"type":18,"value":40},{"type":18,"value":425}," is ",{"type":13,"tag":28,"props":427,"children":429},{"className":428},[],[430],{"type":18,"value":431},"NULL",{"type":18,"value":433}," or a pointer to a structure extending this\nstructure.",{"type":13,"tag":397,"props":435,"children":436},{},[437,443,445,451],{"type":13,"tag":28,"props":438,"children":440},{"className":439},[],[441],{"type":18,"value":442},"physicalDeviceCount",{"type":18,"value":444}," is the number of elements in the\n",{"type":13,"tag":28,"props":446,"children":448},{"className":447},[],[449],{"type":18,"value":450},"pPhysicalDevices",{"type":18,"value":452}," array.",{"type":13,"tag":397,"props":454,"children":455},{},[456,461],{"type":13,"tag":28,"props":457,"children":459},{"className":458},[],[460],{"type":18,"value":450},{"type":18,"value":462}," is a pointer to an array of physical device\nhandles belonging to the same device group.",{"type":13,"tag":14,"props":464,"children":465},{},[466,468,473,475,479,481,486,488,494,496,501],{"type":18,"value":467},"The elements of the ",{"type":13,"tag":28,"props":469,"children":471},{"className":470},[],[472],{"type":18,"value":450},{"type":18,"value":474}," array are an ordered list of the\nphysical devices that the logical device represents.\nThese ",{"type":13,"tag":21,"props":476,"children":478},{"type":477},"must",[],{"type":18,"value":480}," be a subset of a single device group, and need not be in the\nsame order as they were enumerated.\nThe order of the physical devices in the ",{"type":13,"tag":28,"props":482,"children":484},{"className":483},[],[485],{"type":18,"value":450},{"type":18,"value":487}," array\ndetermines the ",{"type":13,"tag":489,"props":490,"children":491},"em",{},[492],{"type":18,"value":493},"device index",{"type":18,"value":495}," of each physical device, with element i\nbeing assigned a device index of i.\nCertain commands and structures refer to one or more physical devices by\nusing device indices or ",{"type":13,"tag":489,"props":497,"children":498},{},[499],{"type":18,"value":500},"device masks",{"type":18,"value":502}," formed using device indices.",{"type":13,"tag":14,"props":504,"children":505},{},[506,508,513,515,520,522,527,529,534,536,542,544,550],{"type":18,"value":507},"A logical device created without using ",{"type":13,"tag":28,"props":509,"children":511},{"className":510},[],[512],{"type":18,"value":4},{"type":18,"value":514},",\nor with ",{"type":13,"tag":28,"props":516,"children":518},{"className":517},[],[519],{"type":18,"value":442},{"type":18,"value":521}," equal to zero, is equivalent to a\n",{"type":13,"tag":28,"props":523,"children":525},{"className":524},[],[526],{"type":18,"value":442},{"type":18,"value":528}," of one and ",{"type":13,"tag":28,"props":530,"children":532},{"className":531},[],[533],{"type":18,"value":450},{"type":18,"value":535}," pointing to the\n",{"type":13,"tag":28,"props":537,"children":539},{"className":538},[],[540],{"type":18,"value":541},"physicalDevice",{"type":18,"value":543}," parameter to ",{"type":13,"tag":44,"props":545,"children":547},{"href":546},"/man/vkCreateDevice",[548],{"type":18,"value":549},"vkCreateDevice",{"type":18,"value":551},".\nIn particular, the device index of that physical device is zero.",{"type":13,"tag":553,"props":554,"children":556},"validity-group",{"name":555},"Valid Usage",[557,579,605],{"type":13,"tag":558,"props":559,"children":561},"validity-field",{"name":560},"VUID-VkDeviceGroupDeviceCreateInfo-pPhysicalDevices-00375",[562],{"type":13,"tag":14,"props":563,"children":564},{},[565,567,572,574,577],{"type":18,"value":566},"Each element of ",{"type":13,"tag":28,"props":568,"children":570},{"className":569},[],[571],{"type":18,"value":450},{"type":18,"value":573}," ",{"type":13,"tag":21,"props":575,"children":576},{"type":477},[],{"type":18,"value":578}," be unique",{"type":13,"tag":558,"props":580,"children":582},{"name":581},"VUID-VkDeviceGroupDeviceCreateInfo-pPhysicalDevices-00376",[583],{"type":13,"tag":14,"props":584,"children":585},{},[586,588,593,594,597,599],{"type":18,"value":587},"All elements of ",{"type":13,"tag":28,"props":589,"children":591},{"className":590},[],[592],{"type":18,"value":450},{"type":18,"value":573},{"type":13,"tag":21,"props":595,"children":596},{"type":477},[],{"type":18,"value":598}," be in the same device group\nas enumerated by ",{"type":13,"tag":44,"props":600,"children":602},{"href":601},"/man/vkEnumeratePhysicalDeviceGroups",[603],{"type":18,"value":604},"vkEnumeratePhysicalDeviceGroups",{"type":13,"tag":558,"props":606,"children":608},{"name":607},"VUID-VkDeviceGroupDeviceCreateInfo-physicalDeviceCount-00377",[609],{"type":13,"tag":14,"props":610,"children":611},{},[612,614,619,621,627,629,634,636,640,641,644,646],{"type":18,"value":613},"If ",{"type":13,"tag":28,"props":615,"children":617},{"className":616},[],[618],{"type":18,"value":442},{"type":18,"value":620}," is not ",{"type":13,"tag":28,"props":622,"children":624},{"className":623},[],[625],{"type":18,"value":626},"0",{"type":18,"value":628},", the ",{"type":13,"tag":28,"props":630,"children":632},{"className":631},[],[633],{"type":18,"value":541},{"type":18,"value":635},"\nparameter of ",{"type":13,"tag":44,"props":637,"children":638},{"href":546},[639],{"type":18,"value":549},{"type":18,"value":573},{"type":13,"tag":21,"props":642,"children":643},{"type":477},[],{"type":18,"value":645}," be an element of\n",{"type":13,"tag":28,"props":647,"children":649},{"className":648},[],[650],{"type":18,"value":450},{"type":13,"tag":553,"props":652,"children":654},{"name":653},"Valid Usage (Implicit)",[655,679],{"type":13,"tag":558,"props":656,"children":658},{"name":657},"VUID-VkDeviceGroupDeviceCreateInfo-sType-sType",[659],{"type":13,"tag":14,"props":660,"children":661},{},[662,667,668,671,673],{"type":13,"tag":28,"props":663,"children":665},{"className":664},[],[666],{"type":18,"value":405},{"type":18,"value":573},{"type":13,"tag":21,"props":669,"children":670},{"type":477},[],{"type":18,"value":672}," be ",{"type":13,"tag":28,"props":674,"children":676},{"className":675},[],[677],{"type":18,"value":678},"VK_STRUCTURE_TYPE_DEVICE_GROUP_DEVICE_CREATE_INFO",{"type":13,"tag":558,"props":680,"children":682},{"name":681},"VUID-VkDeviceGroupDeviceCreateInfo-pPhysicalDevices-parameter",[683],{"type":13,"tag":14,"props":684,"children":685},{},[686,687,692,693,698,700,705,706,709,711,716,718,724],{"type":18,"value":613},{"type":13,"tag":28,"props":688,"children":690},{"className":689},[],[691],{"type":18,"value":442},{"type":18,"value":620},{"type":13,"tag":28,"props":694,"children":696},{"className":695},[],[697],{"type":18,"value":626},{"type":18,"value":699},", ",{"type":13,"tag":28,"props":701,"children":703},{"className":702},[],[704],{"type":18,"value":450},{"type":18,"value":573},{"type":13,"tag":21,"props":707,"children":708},{"type":477},[],{"type":18,"value":710}," be a valid pointer to an array of ",{"type":13,"tag":28,"props":712,"children":714},{"className":713},[],[715],{"type":18,"value":442},{"type":18,"value":717}," valid ",{"type":13,"tag":44,"props":719,"children":721},{"href":720},"/man/VkPhysicalDevice",[722],{"type":18,"value":723},"VkPhysicalDevice",{"type":18,"value":725}," handles",{"type":13,"tag":727,"props":728,"children":729},"style",{},[730],{"type":18,"value":731},"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":70,"searchDepth":100,"depth":100,"links":733},[],"markdown",1725732548560]