28  * This file implements the vmwgfx context binding manager,
41  * already killed if a resource to which a binding points
47  * to protect all binding manager data.
50  * (surface, shader or even DX query) is conceptually a context binding that
69  * struct vmw_ctx_binding_state - per context binding state
75  * @ds_view: Depth-stencil view binding.
78  * @index_buffer: Index buffer binding.
82  * @dirty: Bitmap tracking per binding-type changes that have not yet
84  * @dirty_vb: Bitmap tracking individual vertex buffer binding changes that
86  * @bind_cmd_buffer: Scratch space used to construct binding commands.
87  * @bind_cmd_count: Number of binding command data entries in @bind_cmd_buffer
89  * device binding slot of the first command data entry in @bind_cmd_buffer.
139  * struct vmw_binding_info - Per binding type information for the binding
142  * @size: The size of the struct binding derived from a struct vmw_ctx_bindinfo.
144  * of struct bindings for the binding type.
145  * @scrub_func: Pointer to the scrub function for this binding type.
147  * Holds static information to help optimize the binding manager and avoid
158  * location of the struct vmw_ctx_bindinfo slots for each binding type.
273  * context binding state tracker.
275  * @cbs: The context binding state tracker.
279  * binding state tracker. If there are no active bindings, this function
297  * @bt: The binding type.
298  * @shader_slot: The shader slot of the binding. If none, then set to 0.
299  * @slot: The slot of the binding.
312  * vmw_binding_drop: Stop tracking a context binding
314  * @bi: Pointer to binding tracker storage.
316  * Stops tracking a context binding, and re-initializes its storage.
317  * Typically used when the context binding is replaced with a binding to
329  * vmw_binding_add: Start tracking a context binding
331  * @cbs: Pointer to the context binding state tracker.
332  * @bi: Information about the binding to track.
334  * Starts tracking the binding in the context binding
356  * @cbs: Pointer to the context binding state tracker.
367  * vmw_binding_transfer: Transfer a context binding tracking entry.
369  * @cbs: Pointer to the persistent context binding state tracker.
370  * @bi: Information about the binding to track.
398  * @cbs: Pointer to the context binding state tracker.
401  * context binding state tracker. Then re-initializes the whole structure.
416  * @cbs: Pointer to the context binding state tracker.
419  * context binding state tracker.
438  * resource binding list
440  * @head: list head of resource binding list
456  * resource binding list
458  * @head: list head of resource binding list
485  * vmw_binding_state_commit - Commit staged binding info
487  * @ctx: Pointer to context to commit the staged binding info to.
488  * @from: Staged binding info built during execbuf.
491  * Transfers binding info from a temporary structure
516  * Walks through the context binding list and rebinds all scrubbed
543  * vmw_binding_scrub_shader - scrub a shader binding from a context.
545  * @bi: single binding information.
550 	struct vmw_ctx_bindinfo_shader *binding =  in vmw_binding_scrub_shader()  local
551 		container_of(bi, typeof(*binding), bi);  in vmw_binding_scrub_shader()
565 	cmd->body.type = binding->shader_slot + SVGA3D_SHADERTYPE_MIN;  in vmw_binding_scrub_shader()
573  * vmw_binding_scrub_render_target - scrub a render target binding
576  * @bi: single binding information.
582 	struct vmw_ctx_bindinfo_view *binding =  in vmw_binding_scrub_render_target()  local
583 		container_of(bi, typeof(*binding), bi);  in vmw_binding_scrub_render_target()
597 	cmd->body.type = binding->slot;  in vmw_binding_scrub_render_target()
607  * vmw_binding_scrub_texture - scrub a texture binding from a context.
609  * @bi: single binding information.
618 	struct vmw_ctx_bindinfo_tex *binding =  in vmw_binding_scrub_texture()  local
619 		container_of(bi, typeof(*binding), bi);  in vmw_binding_scrub_texture()
636 	cmd->body.s1.stage = binding->texture_stage;  in vmw_binding_scrub_texture()
645  * vmw_binding_scrub_dx_shader - scrub a dx shader binding from a context.
647  * @bi: single binding information.
652 	struct vmw_ctx_bindinfo_shader *binding =  in vmw_binding_scrub_dx_shader()  local
653 		container_of(bi, typeof(*binding), bi);  in vmw_binding_scrub_dx_shader()
666 	cmd->body.type = binding->shader_slot + SVGA3D_SHADERTYPE_MIN;  in vmw_binding_scrub_dx_shader()
674  * vmw_binding_scrub_cb - scrub a constant buffer binding from a context.
676  * @bi: single binding information.
681 	struct vmw_ctx_bindinfo_cb *binding =  in vmw_binding_scrub_cb()  local
682 		container_of(bi, typeof(*binding), bi);  in vmw_binding_scrub_cb()
695 	cmd->body.slot = binding->slot;  in vmw_binding_scrub_cb()
696 	cmd->body.type = binding->shader_slot + SVGA3D_SHADERTYPE_MIN;  in vmw_binding_scrub_cb()
698 		cmd->body.offsetInBytes = binding->offset;  in vmw_binding_scrub_cb()
699 		cmd->body.sizeInBytes = binding->size;  in vmw_binding_scrub_cb()
712  * vmw_collect_view_ids - Build view id data for a view binding command
716  * @bi: Pointer to where the binding info array is stored in @cbs
720  * Stops at the first non-existing binding in the @bi array.
747  * vmw_collect_dirty_view_ids - Build view id data for a view binding command
750  * @bi: Pointer to where the binding info array is stored in @cbs
758  * binding, and @cbs->bind_cmd_buffer contains the command data.
789  * vmw_binding_emit_set_sr - Issue delayed DX shader resource binding commands
832  * vmw_binding_emit_set_rt - Issue delayed DX rendertarget binding commands
870  * vmw_collect_so_targets - Build SVGA3dSoTarget data for a binding command
874  * @bi: Pointer to where the binding info array is stored in @cbs
878  * Stops at the first non-existing binding in the @bi array.
913  * vmw_emit_set_so_target - Issue delayed streamout binding commands
948  * vmw_binding_emit_dirty_ps - Issue delayed per shader binding commands
978  * @bi: Pointer to where the binding info array is stored in @cbs
986  * binding, and @cbs->bind_cmd_buffer contains the command data.
1024  * vmw_binding_emit_set_vb - Issue delayed vertex buffer binding commands
1125  * vmw_binding_emit_dirty - Issue delayed binding commands
1129  * This function issues the delayed binding commands that arise from
1130  * previous scrub / unscrub calls. These binding commands are typically
1175  * vmw_binding_scrub_sr - Schedule a dx shaderresource binding
1178  * @bi: single binding information.
1197  * vmw_binding_scrub_dx_rt - Schedule a dx rendertarget binding
1200  * @bi: single binding information.
1214  * vmw_binding_scrub_so_target - Schedule a dx streamoutput buffer binding
1217  * @bi: single binding information.
1231  * vmw_binding_scrub_vb - Schedule a dx vertex buffer binding
1234  * @bi: single binding information.
1251  * vmw_binding_scrub_ib - scrub a dx index buffer binding from a context
1253  * @bi: single binding information.
1258 	struct vmw_ctx_bindinfo_ib *binding =  in vmw_binding_scrub_ib()  local
1259 		container_of(bi, typeof(*binding), bi);  in vmw_binding_scrub_ib()
1274 		cmd->body.format = binding->format;  in vmw_binding_scrub_ib()
1275 		cmd->body.offset = binding->offset;  in vmw_binding_scrub_ib()
1304  * vmw_binding_scrub_so - Scrub a streamoutput binding from context.
1305  * @bi: Single binding information.
1310 	struct vmw_ctx_bindinfo_so *binding =  in vmw_binding_scrub_so()  local
1311 		container_of(bi, typeof(*binding), bi);  in vmw_binding_scrub_so()
1380  * vmw_binding_state_list - Get the binding list of a
1385  * Returns the binding list which can be used to traverse through the bindings
1398  * Drops all bindings registered in @cbs. No device binding actions are
1410  * vmw_binding_dirtying - Return whether a binding type is dirtying its resource
1411  * @binding_type: The binding type
1414  * context binding referencing it, we need to determine whether that resource
1419  * Return: Whether the binding type dirties the resource its binding points to.