 |
HS_pushEmptyFIFONode |
Function (ROM Call*) |
Inserts a new almost-empty FIFO node into the history.
HS_pushEmptyFIFONode inserts the entry/answer pair identified by Node
into the linked list of FIFO nodes. Node must contain a handle to a
FIFO_NODE structure, but only the Expr
fields of the entry and answer need to be filled. It should have
been allocated using HS_newFIFONode.
This function first fills the structure pointed to by Node, then calls
HS_pushFIFONode to insert the new node.
Unfortunately, it also calls
ST_stack from
statline.h to redraw the history status
line indicator of the Home Screen, which can not be prevented using
PortSet or the method used in
HomeStore.
In theory, it is possible to fill the structure by hand, but this is very
tedious.
Note: The address of the HS_pushEmptyFIFONode function is not in the
jump table of any AMS version up to 2.05, and probably will never be. Getting
the address of this function is implemented using a very dirty hack.
However, it is the main function for storing items in the Home Screen
history, so you probably cannot avoid it unless you want to fill the
FIFO_NODE structure yourself. An error is
thrown if the address of this function could not be determined.
Uses: HS_pushFIFONode
Used by: HomePushEStack, HomeStorePair
See also: HS_pushFIFONode, HomeStorePair