kStatus kPxBlock_AssignGroup	(	kPxBlock	block,
		k32u	groupId
	)

Assigns this block to a processing group.

By default, blocks in concurrent pipe environments are independently scheduled for execution. The kPxBlock_AssignGroup function can be used to create larger processing groups, so that multiple blocks are executed together. This technique can be used to optimize pipe execution by reducing context switching overhead, particulary when dealing with lightweight blocks.

This function is typically called from within the pipe framework. However, this function call also be used when unit-testing blocks.

Parameters

block	Block object.
groupId	Processing group id.

Returns

Operation status.