[{"data":1,"prerenderedAt":498},["ShallowReactive",2],{"sQH5t8af21":3},{"title":4,"description":5,"parent":6,"type":7,"xrefs":8,"body":9,"_type":497,"_id":4},"vkCmdSetDeviceMask","Modify device mask of a command buffer","VK_VERSION_1_1","protos",[],{"type":10,"children":11,"toc":495},"root",[12,20,193,219,245,360,443,489],{"type":13,"tag":14,"props":15,"children":16},"element","p",{},[17],{"type":18,"value":19},"text","To update the current device mask of a command buffer, call:",{"type":13,"tag":21,"props":22,"children":23},"code-group",{},[24,100],{"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","void vkCmdSetDeviceMaskKHR(\n    VkCommandBuffer commandBuffer,\n    uint32_t deviceMask);\n","C","c","",[33],{"type":13,"tag":34,"props":35,"children":36},"code",{"__ignoreMap":31},[37,61,81],{"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:#CF222E;--shiki-dark:#FF7B72",[47],{"type":18,"value":48},"void",{"type":13,"tag":38,"props":50,"children":52},{"style":51},"--shiki-default:#8250DF;--shiki-dark:#D2A8FF",[53],{"type":18,"value":54}," vkCmdSetDeviceMaskKHR",{"type":13,"tag":38,"props":56,"children":58},{"style":57},"--shiki-default:#1F2328;--shiki-dark:#E6EDF3",[59],{"type":18,"value":60},"(\n",{"type":13,"tag":38,"props":62,"children":64},{"class":40,"line":63},2,[65,70,76],{"type":13,"tag":38,"props":66,"children":67},{"style":57},[68],{"type":18,"value":69},"    VkCommandBuffer ",{"type":13,"tag":38,"props":71,"children":73},{"style":72},"--shiki-default:#953800;--shiki-dark:#FFA657",[74],{"type":18,"value":75},"commandBuffer",{"type":13,"tag":38,"props":77,"children":78},{"style":57},[79],{"type":18,"value":80},",\n",{"type":13,"tag":38,"props":82,"children":84},{"class":40,"line":83},3,[85,90,95],{"type":13,"tag":38,"props":86,"children":87},{"style":45},[88],{"type":18,"value":89},"    uint32_t",{"type":13,"tag":38,"props":91,"children":92},{"style":72},[93],{"type":18,"value":94}," deviceMask",{"type":13,"tag":38,"props":96,"children":97},{"style":57},[98],{"type":18,"value":99},");\n",{"type":13,"tag":25,"props":101,"children":106},{"className":102,"code":103,"filename":104,"language":105,"meta":31,"style":31},"language-rs shiki shiki-themes github-light-default github-dark-default","pub fn cmd_set_device_mask_khr(\n    command_buffer: vk::CommandBuffer,\n    device_mask: u32,\n);\n","Rust","rs",[107],{"type":13,"tag":34,"props":108,"children":109},{"__ignoreMap":31},[110,132,164,185],{"type":13,"tag":38,"props":111,"children":112},{"class":40,"line":41},[113,118,123,128],{"type":13,"tag":38,"props":114,"children":115},{"style":45},[116],{"type":18,"value":117},"pub",{"type":13,"tag":38,"props":119,"children":120},{"style":45},[121],{"type":18,"value":122}," fn",{"type":13,"tag":38,"props":124,"children":125},{"style":51},[126],{"type":18,"value":127}," cmd_set_device_mask_khr",{"type":13,"tag":38,"props":129,"children":130},{"style":57},[131],{"type":18,"value":60},{"type":13,"tag":38,"props":133,"children":134},{"class":40,"line":63},[135,140,145,150,155,160],{"type":13,"tag":38,"props":136,"children":137},{"style":57},[138],{"type":18,"value":139},"    command_buffer",{"type":13,"tag":38,"props":141,"children":142},{"style":45},[143],{"type":18,"value":144},":",{"type":13,"tag":38,"props":146,"children":147},{"style":72},[148],{"type":18,"value":149}," vk",{"type":13,"tag":38,"props":151,"children":152},{"style":45},[153],{"type":18,"value":154},"::",{"type":13,"tag":38,"props":156,"children":157},{"style":72},[158],{"type":18,"value":159},"CommandBuffer",{"type":13,"tag":38,"props":161,"children":162},{"style":57},[163],{"type":18,"value":80},{"type":13,"tag":38,"props":165,"children":166},{"class":40,"line":83},[167,172,176,181],{"type":13,"tag":38,"props":168,"children":169},{"style":57},[170],{"type":18,"value":171},"    device_mask",{"type":13,"tag":38,"props":173,"children":174},{"style":45},[175],{"type":18,"value":144},{"type":13,"tag":38,"props":177,"children":178},{"style":72},[179],{"type":18,"value":180}," u32",{"type":13,"tag":38,"props":182,"children":183},{"style":57},[184],{"type":18,"value":80},{"type":13,"tag":38,"props":186,"children":188},{"class":40,"line":187},4,[189],{"type":13,"tag":38,"props":190,"children":191},{"style":57},[192],{"type":18,"value":99},{"type":13,"tag":194,"props":195,"children":196},"ul",{},[197,208],{"type":13,"tag":198,"props":199,"children":200},"li",{},[201,206],{"type":13,"tag":34,"props":202,"children":204},{"className":203},[],[205],{"type":18,"value":75},{"type":18,"value":207}," is command buffer whose current device mask is\nmodified.",{"type":13,"tag":198,"props":209,"children":210},{},[211,217],{"type":13,"tag":34,"props":212,"children":214},{"className":213},[],[215],{"type":18,"value":216},"deviceMask",{"type":18,"value":218}," is the new value of the current device mask.",{"type":13,"tag":14,"props":220,"children":221},{},[222,227,229,234,236,243],{"type":13,"tag":34,"props":223,"children":225},{"className":224},[],[226],{"type":18,"value":216},{"type":18,"value":228}," is used to filter out subsequent commands from executing on\nall physical devices whose bit indices are not set in the mask, except\ncommands beginning a render pass instance, commands transitioning to the\nnext subpass in the render pass instance, and commands ending a render pass\ninstance, which always execute on the set of physical devices whose bit\nindices are included in the ",{"type":13,"tag":34,"props":230,"children":232},{"className":231},[],[233],{"type":18,"value":216},{"type":18,"value":235}," member of the\n",{"type":13,"tag":237,"props":238,"children":240},"a",{"href":239},"/man/VkDeviceGroupRenderPassBeginInfo",[241],{"type":18,"value":242},"VkDeviceGroupRenderPassBeginInfo",{"type":18,"value":244}," structure passed to the command\nbeginning the corresponding render pass instance.",{"type":13,"tag":246,"props":247,"children":249},"validity-group",{"name":248},"Valid Usage",[250,272,290,322],{"type":13,"tag":251,"props":252,"children":254},"validity-field",{"name":253},"VUID-vkCmdSetDeviceMask-deviceMask-00108",[255],{"type":13,"tag":14,"props":256,"children":257},{},[258,263,265,270],{"type":13,"tag":34,"props":259,"children":261},{"className":260},[],[262],{"type":18,"value":216},{"type":18,"value":264}," ",{"type":13,"tag":266,"props":267,"children":269},"normative",{"type":268},"must",[],{"type":18,"value":271}," be a valid device mask value",{"type":13,"tag":251,"props":273,"children":275},{"name":274},"VUID-vkCmdSetDeviceMask-deviceMask-00109",[276],{"type":13,"tag":14,"props":277,"children":278},{},[279,284,285,288],{"type":13,"tag":34,"props":280,"children":282},{"className":281},[],[283],{"type":18,"value":216},{"type":18,"value":264},{"type":13,"tag":266,"props":286,"children":287},{"type":268},[],{"type":18,"value":289}," not be zero",{"type":13,"tag":251,"props":291,"children":293},{"name":292},"VUID-vkCmdSetDeviceMask-deviceMask-00110",[294],{"type":13,"tag":14,"props":295,"children":296},{},[297,302,303,306,308,314,315,320],{"type":13,"tag":34,"props":298,"children":300},{"className":299},[],[301],{"type":18,"value":216},{"type":18,"value":264},{"type":13,"tag":266,"props":304,"children":305},{"type":268},[],{"type":18,"value":307}," not include any set bits that were not in the\n",{"type":13,"tag":237,"props":309,"children":311},{"href":310},"/man/VkDeviceGroupCommandBufferBeginInfo",[312],{"type":18,"value":313},"VkDeviceGroupCommandBufferBeginInfo",{"type":18,"value":154},{"type":13,"tag":34,"props":316,"children":318},{"className":317},[],[319],{"type":18,"value":216},{"type":18,"value":321}," value when\nthe command buffer began recording",{"type":13,"tag":251,"props":323,"children":325},{"name":324},"VUID-vkCmdSetDeviceMask-deviceMask-00111",[326],{"type":13,"tag":14,"props":327,"children":328},{},[329,331,336,338,343,344,347,348,352,353,358],{"type":18,"value":330},"If ",{"type":13,"tag":34,"props":332,"children":334},{"className":333},[],[335],{"type":18,"value":4},{"type":18,"value":337}," is called inside a render pass instance,\n",{"type":13,"tag":34,"props":339,"children":341},{"className":340},[],[342],{"type":18,"value":216},{"type":18,"value":264},{"type":13,"tag":266,"props":345,"children":346},{"type":268},[],{"type":18,"value":307},{"type":13,"tag":237,"props":349,"children":350},{"href":239},[351],{"type":18,"value":242},{"type":18,"value":154},{"type":13,"tag":34,"props":354,"children":356},{"className":355},[],[357],{"type":18,"value":216},{"type":18,"value":359}," value when the\nrender pass instance began recording",{"type":13,"tag":246,"props":361,"children":363},{"name":362},"Valid Usage (Implicit)",[364,390,414],{"type":13,"tag":251,"props":365,"children":367},{"name":366},"VUID-vkCmdSetDeviceMask-commandBuffer-parameter",[368],{"type":13,"tag":14,"props":369,"children":370},{},[371,376,377,380,382,388],{"type":13,"tag":34,"props":372,"children":374},{"className":373},[],[375],{"type":18,"value":75},{"type":18,"value":264},{"type":13,"tag":266,"props":378,"children":379},{"type":268},[],{"type":18,"value":381}," be a valid ",{"type":13,"tag":237,"props":383,"children":385},{"href":384},"/man/VkCommandBuffer",[386],{"type":18,"value":387},"VkCommandBuffer",{"type":18,"value":389}," handle",{"type":13,"tag":251,"props":391,"children":393},{"name":392},"VUID-vkCmdSetDeviceMask-commandBuffer-recording",[394],{"type":13,"tag":14,"props":395,"children":396},{},[397,402,403,406,408],{"type":13,"tag":34,"props":398,"children":400},{"className":399},[],[401],{"type":18,"value":75},{"type":18,"value":264},{"type":13,"tag":266,"props":404,"children":405},{"type":268},[],{"type":18,"value":407}," be in the ",{"type":13,"tag":237,"props":409,"children":411},{"href":410},"/chapters/commandbuffers#commandbuffers-lifecycle",[412],{"type":18,"value":413},"recording state",{"type":13,"tag":251,"props":415,"children":417},{"name":416},"VUID-vkCmdSetDeviceMask-commandBuffer-cmdpool",[418],{"type":13,"tag":14,"props":419,"children":420},{},[421,423,429,431,436,438,441],{"type":18,"value":422},"The ",{"type":13,"tag":34,"props":424,"children":426},{"className":425},[],[427],{"type":18,"value":428},"VkCommandPool",{"type":18,"value":430}," that ",{"type":13,"tag":34,"props":432,"children":434},{"className":433},[],[435],{"type":18,"value":75},{"type":18,"value":437}," was allocated from ",{"type":13,"tag":266,"props":439,"children":440},{"type":268},[],{"type":18,"value":442}," support graphics, compute, or transfer operations",{"type":13,"tag":444,"props":445,"children":447},"validity-box",{"name":446},"Host Synchronization",[448],{"type":13,"tag":194,"props":449,"children":450},{},[451,467],{"type":13,"tag":198,"props":452,"children":453},{},[454,456,461,462,465],{"type":18,"value":455},"Host access to ",{"type":13,"tag":34,"props":457,"children":459},{"className":458},[],[460],{"type":18,"value":75},{"type":18,"value":264},{"type":13,"tag":266,"props":463,"children":464},{"type":268},[],{"type":18,"value":466}," be externally synchronized",{"type":13,"tag":198,"props":468,"children":469},{},[470,472,477,478,483,484,487],{"type":18,"value":471},"Host access to the ",{"type":13,"tag":34,"props":473,"children":475},{"className":474},[],[476],{"type":18,"value":428},{"type":18,"value":430},{"type":13,"tag":34,"props":479,"children":481},{"className":480},[],[482],{"type":18,"value":75},{"type":18,"value":437},{"type":13,"tag":266,"props":485,"children":486},{"type":268},[],{"type":18,"value":488}," be externally synchronized\n::",{"type":13,"tag":490,"props":491,"children":492},"style",{},[493],{"type":18,"value":494},"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":63,"depth":63,"links":496},[],"markdown",1725732608745]