[Main]
Name=HS_pushEmptyFIFONode
Type=Function
Subtype=ROM Call
Header Files=homescr.h
Definition=void HS_pushEmptyFIFONode (HANDLE Node);
Real Definition=#define HS_pushEmptyFIFONode (*(__get_HS_pushEmptyFIFONode ()))
See Also=homescr.h/HS_pushFIFONode, homescr.h/HomeStorePair

[Description]
Inserts a new almost-empty FIFO node into the history.

[Explanation]
HS_pushEmptyFIFONode inserts the entry/answer pair identified by <I>Node</I>
into the linked list of FIFO nodes. <I>Node</I> must contain a handle to a
<A HREF="$$LINK(homescr.h/FIFO_NODE)">FIFO_NODE</A> structure, but only the <I>Expr</I>
fields of the entry and answer need to be filled. It should have
been allocated using <A HREF="$$LINK(homescr.h/HS_newFIFONode)">HS_newFIFONode</A>.
<BR><BR>
This function first fills the structure pointed to by <I>Node</I>, then calls
<A HREF="$$LINK(homescr.h/HS_pushFIFONode)">HS_pushFIFONode</A> to insert the new node.
Unfortunately, it also calls
<A HREF="$$LINK(statline.h/ST_stack)">ST_stack</A> from
<A HREF="$$LINK(statline.h/)">statline.h</A> to redraw the history status
line indicator of the Home Screen, which can not be prevented using
<A HREF="$$LINK(graph.h/PortSet)">PortSet</A> or the method used in
<A HREF="$$LINK(homescr.h/HomeStore)">HomeStore</A>.
In theory, it is possible to fill the structure by hand, but this is very
tedious.
<BR><BR>
<B>Note:</B> 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 <I>very</I> 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
<A HREF="$$LINK(homescr.h/FIFO_NODE)">FIFO_NODE</A> structure yourself. An error is
thrown if the address of this function could not be determined.

[References]
In=homescr.h/HomePushEStack, homescr.h/HomeStorePair
Out=homescr.h/HS_pushFIFONode
