Home / Autodocs / amigaguide.library
NAME
- GetAmigaGuideMsg
-
Receive async AmigaGuide message. (V34)
SYNOPSIS
FUNCTION
This function returns a SIPC message from the AmigaGuide system, if there is a message available.
INPUTS
- handle
-
Handle to a AmigaGuide system.
EXAMPLE
AMIGAGUIDECONTEXT handle;
struct AmigaGuideMsg *agm;
/* get a AmigaGuide message */
while (agm = GetAmigaGuideMsg(handle))
{
}
struct AmigaGuideMsg *agm;
/* get a AmigaGuide message */
while (agm = GetAmigaGuideMsg(handle))
{
/* process the event */
switch (agm->agm_Type)
{
}
/* reply to the AmigaGuide message */
ReplyAmigaGuideMsg(agm);
switch (agm->agm_Type)
{
case ToolCmdReplyID: /* a command has completed */
case ToolStatusID: /* status message */
default:
if (agm->agm_Pri_Ret)
{
}
break;
{
/* An error occurred, the reason is in agm_Sec_Ret.
* The command string is in agm_Data
*/
*/
break;
if (agm->agm_Pri_Ret)
{
}
break;
{
/* an error occurred, the reason is in agm_Sec_Ret */
break;
break;
/* reply to the AmigaGuide message */
ReplyAmigaGuideMsg(agm);
RESULT
- msg
-
Pointer to a SIPC message or NULL if no message was available.