[{"data":1,"prerenderedAt":462},["ShallowReactive",2],{"$fbV53jw5O7z08Nms2iDjegyzQewSapSFO4f1nVuL_wqw":3},{"title":4,"description":5,"parent":6,"cmd_buf_level":7,"render_pass_scope":10,"supported_queue_types":11,"tasks":13,"type":15,"xrefs":16,"body":17,"_type":461,"_id":4},"vkCmdSetComputeOccupancyPriorityNV","Set the compute occupancy priority for subsequent compute dispatches","VK_NV_compute_occupancy_priority",[8,9],"primary","secondary","both",[12],"VK_QUEUE_COMPUTE_BIT",[14],"state","protos",[],{"type":18,"children":19,"toc":459},"root",[20,28,224,259,277,290,423,453],{"type":21,"tag":22,"props":23,"children":24},"element","p",{},[25],{"type":26,"value":27},"text","To set the compute occupancy priority for subsequent compute dispatches,\ncall:",{"type":21,"tag":29,"props":30,"children":31},"code-group",{},[32,118],{"type":21,"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","void vkCmdSetComputeOccupancyPriorityNV(\n    VkCommandBuffer commandBuffer,\n    const VkComputeOccupancyPriorityParametersNV* pParameters);\n","C","c","",[41],{"type":21,"tag":42,"props":43,"children":44},"code",{"__ignoreMap":39},[45,69,89],{"type":21,"tag":46,"props":47,"children":50},"span",{"class":48,"line":49},"line",1,[51,57,63],{"type":21,"tag":46,"props":52,"children":54},{"style":53},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[55],{"type":26,"value":56},"void",{"type":21,"tag":46,"props":58,"children":60},{"style":59},"--shiki-default:#8250DF;--shiki-dark:#D2A8FF",[61],{"type":26,"value":62}," vkCmdSetComputeOccupancyPriorityNV",{"type":21,"tag":46,"props":64,"children":66},{"style":65},"--shiki-default:#1F2328;--shiki-dark:#E6EDF3",[67],{"type":26,"value":68},"(\n",{"type":21,"tag":46,"props":70,"children":72},{"class":48,"line":71},2,[73,78,84],{"type":21,"tag":46,"props":74,"children":75},{"style":65},[76],{"type":26,"value":77},"    VkCommandBuffer ",{"type":21,"tag":46,"props":79,"children":81},{"style":80},"--shiki-default:#953800;--shiki-dark:#FFA657",[82],{"type":26,"value":83},"commandBuffer",{"type":21,"tag":46,"props":85,"children":86},{"style":65},[87],{"type":26,"value":88},",\n",{"type":21,"tag":46,"props":90,"children":92},{"class":48,"line":91},3,[93,98,103,108,113],{"type":21,"tag":46,"props":94,"children":95},{"style":53},[96],{"type":26,"value":97},"    const",{"type":21,"tag":46,"props":99,"children":100},{"style":65},[101],{"type":26,"value":102}," VkComputeOccupancyPriorityParametersNV",{"type":21,"tag":46,"props":104,"children":105},{"style":53},[106],{"type":26,"value":107},"*",{"type":21,"tag":46,"props":109,"children":110},{"style":80},[111],{"type":26,"value":112}," pParameters",{"type":21,"tag":46,"props":114,"children":115},{"style":65},[116],{"type":26,"value":117},");\n",{"type":21,"tag":33,"props":119,"children":124},{"className":120,"code":121,"filename":122,"language":123,"meta":39,"style":39},"language-rs shiki shiki-themes github-light-default github-dark-default","pub fn cmd_set_compute_occupancy_priority_nv(\n    command_buffer: vk::CommandBuffer,\n    p_parameters: *const vk::ComputeOccupancyPriorityParametersNV,\n);\n","Rust","rs",[125],{"type":21,"tag":42,"props":126,"children":127},{"__ignoreMap":39},[128,150,182,216],{"type":21,"tag":46,"props":129,"children":130},{"class":48,"line":49},[131,136,141,146],{"type":21,"tag":46,"props":132,"children":133},{"style":53},[134],{"type":26,"value":135},"pub",{"type":21,"tag":46,"props":137,"children":138},{"style":53},[139],{"type":26,"value":140}," fn",{"type":21,"tag":46,"props":142,"children":143},{"style":59},[144],{"type":26,"value":145}," cmd_set_compute_occupancy_priority_nv",{"type":21,"tag":46,"props":147,"children":148},{"style":65},[149],{"type":26,"value":68},{"type":21,"tag":46,"props":151,"children":152},{"class":48,"line":71},[153,158,163,168,173,178],{"type":21,"tag":46,"props":154,"children":155},{"style":65},[156],{"type":26,"value":157},"    command_buffer",{"type":21,"tag":46,"props":159,"children":160},{"style":53},[161],{"type":26,"value":162},":",{"type":21,"tag":46,"props":164,"children":165},{"style":80},[166],{"type":26,"value":167}," vk",{"type":21,"tag":46,"props":169,"children":170},{"style":53},[171],{"type":26,"value":172},"::",{"type":21,"tag":46,"props":174,"children":175},{"style":80},[176],{"type":26,"value":177},"CommandBuffer",{"type":21,"tag":46,"props":179,"children":180},{"style":65},[181],{"type":26,"value":88},{"type":21,"tag":46,"props":183,"children":184},{"class":48,"line":91},[185,190,194,199,203,207,212],{"type":21,"tag":46,"props":186,"children":187},{"style":65},[188],{"type":26,"value":189},"    p_parameters",{"type":21,"tag":46,"props":191,"children":192},{"style":53},[193],{"type":26,"value":162},{"type":21,"tag":46,"props":195,"children":196},{"style":53},[197],{"type":26,"value":198}," *const",{"type":21,"tag":46,"props":200,"children":201},{"style":80},[202],{"type":26,"value":167},{"type":21,"tag":46,"props":204,"children":205},{"style":53},[206],{"type":26,"value":172},{"type":21,"tag":46,"props":208,"children":209},{"style":80},[210],{"type":26,"value":211},"ComputeOccupancyPriorityParametersNV",{"type":21,"tag":46,"props":213,"children":214},{"style":65},[215],{"type":26,"value":88},{"type":21,"tag":46,"props":217,"children":219},{"class":48,"line":218},4,[220],{"type":21,"tag":46,"props":221,"children":222},{"style":65},[223],{"type":26,"value":117},{"type":21,"tag":225,"props":226,"children":227},"ul",{},[228,239],{"type":21,"tag":229,"props":230,"children":231},"li",{},[232,237],{"type":21,"tag":42,"props":233,"children":235},{"className":234},[],[236],{"type":26,"value":83},{"type":26,"value":238}," is the command buffer into which the command will be\nrecorded.",{"type":21,"tag":229,"props":240,"children":241},{},[242,248,250,257],{"type":21,"tag":42,"props":243,"children":245},{"className":244},[],[246],{"type":26,"value":247},"pParameters",{"type":26,"value":249}," is a pointer to a\n",{"type":21,"tag":251,"props":252,"children":254},"a",{"href":253},"/man/VkComputeOccupancyPriorityParametersNV",[255],{"type":26,"value":256},"VkComputeOccupancyPriorityParametersNV",{"type":26,"value":258}," structure specifying the\noccupancy priority parameters.",{"type":21,"tag":22,"props":260,"children":261},{},[262,264,269,271,275],{"type":26,"value":263},"The occupancy priority affects how compute workloads utilize GPU compute\nresources relative to other simultaneously executing workloads.\nThe priority is stateful on a command buffer.\nAll compute dispatch commands issued subsequent to a\n",{"type":21,"tag":251,"props":265,"children":267},{"href":266},"/man/vkCmdSetComputeOccupancyPriorityNV",[268],{"type":26,"value":4},{"type":26,"value":270}," call will be executed with the\nspecified priority parameters until another\n",{"type":21,"tag":251,"props":272,"children":273},{"href":266},[274],{"type":26,"value":4},{"type":26,"value":276}," call is made.",{"type":21,"tag":22,"props":278,"children":279},{},[280,282,288],{"type":26,"value":281},"All command buffers (primary and secondary) start with a priority level\nequal to the ",{"type":21,"tag":42,"props":283,"children":285},{"className":284},[],[286],{"type":26,"value":287},"VK_COMPUTE_OCCUPANCY_PRIORITY_NORMAL_NV",{"type":26,"value":289}," value.\nThe priority state is not inherited by secondary command buffers - each\ncommand buffer maintains its own independent priority state.",{"type":21,"tag":291,"props":292,"children":294},"validity-group",{"name":293},"Valid Usage (Implicit)",[295,325,349,373,409],{"type":21,"tag":296,"props":297,"children":299},"validity-field",{"name":298},"VUID-vkCmdSetComputeOccupancyPriorityNV-commandBuffer-parameter",[300],{"type":21,"tag":22,"props":301,"children":302},{},[303,308,310,315,317,323],{"type":21,"tag":42,"props":304,"children":306},{"className":305},[],[307],{"type":26,"value":83},{"type":26,"value":309}," ",{"type":21,"tag":311,"props":312,"children":314},"normative",{"type":313},"must",[],{"type":26,"value":316}," be a valid ",{"type":21,"tag":251,"props":318,"children":320},{"href":319},"/man/VkCommandBuffer",[321],{"type":26,"value":322},"VkCommandBuffer",{"type":26,"value":324}," handle",{"type":21,"tag":296,"props":326,"children":328},{"name":327},"VUID-vkCmdSetComputeOccupancyPriorityNV-pParameters-parameter",[329],{"type":21,"tag":22,"props":330,"children":331},{},[332,337,338,341,343,347],{"type":21,"tag":42,"props":333,"children":335},{"className":334},[],[336],{"type":26,"value":247},{"type":26,"value":309},{"type":21,"tag":311,"props":339,"children":340},{"type":313},[],{"type":26,"value":342}," be a valid pointer to a valid ",{"type":21,"tag":251,"props":344,"children":345},{"href":253},[346],{"type":26,"value":256},{"type":26,"value":348}," structure",{"type":21,"tag":296,"props":350,"children":352},{"name":351},"VUID-vkCmdSetComputeOccupancyPriorityNV-commandBuffer-recording",[353],{"type":21,"tag":22,"props":354,"children":355},{},[356,361,362,365,367],{"type":21,"tag":42,"props":357,"children":359},{"className":358},[],[360],{"type":26,"value":83},{"type":26,"value":309},{"type":21,"tag":311,"props":363,"children":364},{"type":313},[],{"type":26,"value":366}," be in the ",{"type":21,"tag":251,"props":368,"children":370},{"href":369},"/chapters/commandbuffers#commandbuffers-lifecycle",[371],{"type":26,"value":372},"recording state",{"type":21,"tag":296,"props":374,"children":376},{"name":375},"VUID-vkCmdSetComputeOccupancyPriorityNV-commandBuffer-cmdpool",[377],{"type":21,"tag":22,"props":378,"children":379},{},[380,382,388,390,395,397,400,402,407],{"type":26,"value":381},"The ",{"type":21,"tag":42,"props":383,"children":385},{"className":384},[],[386],{"type":26,"value":387},"VkCommandPool",{"type":26,"value":389}," that ",{"type":21,"tag":42,"props":391,"children":393},{"className":392},[],[394],{"type":26,"value":83},{"type":26,"value":396}," was allocated from ",{"type":21,"tag":311,"props":398,"children":399},{"type":313},[],{"type":26,"value":401}," support ",{"type":21,"tag":42,"props":403,"children":405},{"className":404},[],[406],{"type":26,"value":12},{"type":26,"value":408}," operations",{"type":21,"tag":296,"props":410,"children":412},{"name":411},"VUID-vkCmdSetComputeOccupancyPriorityNV-videocoding",[413],{"type":21,"tag":22,"props":414,"children":415},{},[416,418,421],{"type":26,"value":417},"This command ",{"type":21,"tag":311,"props":419,"children":420},{"type":313},[],{"type":26,"value":422}," only be called outside of a video coding scope",{"type":21,"tag":424,"props":425,"children":427},"validity-box",{"name":426},"Host Synchronization",[428],{"type":21,"tag":225,"props":429,"children":430},{},[431],{"type":21,"tag":229,"props":432,"children":433},{},[434,436,441,442,447,448,451],{"type":26,"value":435},"Host access to the ",{"type":21,"tag":42,"props":437,"children":439},{"className":438},[],[440],{"type":26,"value":387},{"type":26,"value":389},{"type":21,"tag":42,"props":443,"children":445},{"className":444},[],[446],{"type":26,"value":83},{"type":26,"value":396},{"type":21,"tag":311,"props":449,"children":450},{"type":313},[],{"type":26,"value":452}," be externally synchronized",{"type":21,"tag":454,"props":455,"children":456},"style",{},[457],{"type":26,"value":458},"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":71,"depth":71,"links":460},[],"markdown",1773121637791]