Changes the priority of an item.
int32 SetItemPri( Item i, uint8 newpri )
This procedure changes the priority of an item. Some items in the operating system are maintained in lists; for example, tasks and threads. Some lists are ordered by priority, with higher-priority items coming before lower-priority items. When the priority of an item in a list changes, the kernel automatically rearranges the list of items to reflect the new priority. The item is moved immediately before the first item whose priority is lower.
A task must own an item to change its priority. A task can change its own priority even if it does not own itself.
The procedure returns the previous priority of the item or an error code if an error occurs.
SWI implemented in kernel folio V20.
For certain item types, such as devices, the kernel may change the priority of an item to help optimize throughput.
This function is not implemented for all known item types.
CreateItem
()