Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-Fileappl_read()
shel_write()
Application Services Library
appl_write()                                                            AES

Syntax

WORD appl_write( ap_id, length, msg )
WORD ap_id, length;
VOIDP msg;

Function       appl_write() can be used to send a message to a valid
               message pipe.

Opcode         12 (0x0C)

Availability   All AES versions.

Parameters     ap_id is the application identifier of the process to which
               you wish to send the message.
               length specifies the number of bytes present in
               the message.
               msg is a pointer to a memory buffer with at least
               length bytes available.

Binding        intin[0] = ap_id;
               intin[1] = length;

               addrin[0] = msg;

               return crys_if(0x0C);

Return Value   appl_write() returns 0 if an error occurred or greater than
               0 if the message was sent successfully.

Version Notes  As of AES version 1.40, desk accessories may send
               MN_SELECTED messages to the desktop to trigger desktop
               functions.
               As of AES version 4.00 you can use shel_write(7,...) to
               'broadcast' a message to all processes running with the
               exception of the AES itself, the desktop, and your own
               application. See shel_write() for details.

Comments       It is recommended that you always send messages in 16 byte
               blocks using a WORD array of 8 elements as the AES does.

See Also       appl_read(), shel_write()

Group          Application Services Library