Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File8.3.13  appl_write                                                 TOS

 Name:         »Application write« - Send AES message to another 
               application.

 Opcode:       12

 Syntax:       int16_t appl_write ( int16_t ap_wid, int16_t 
               ap_wlength, void *ap_wpbuff );

 Description:  The call appl_write writes a number of bytes to a valid 
               message pipe. The following apply:

                Parameter  Meaning

                ap_wid     ID of the application to which the message 
                           is to be sent
                ap_wlength Number of bytes to be sent
                ap_wpbuff  Address of buffer containing the message to 
                           be transferred

               Notes: With this function an application has the possi- 
               bility to send itself and receive a redraw message. As 
               of MagiC Version 4.0 the following applies: if the 
               parameter ap_wid has the value -2, then ap_wpbuff 
               points to a XAESMSG structure.

               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 one can send shel_write(7...) to 
               'broadcast' a message to all running processes apart 
               from the AES itself, the desktop and one's own 
               application.

 Return value: If a zero is returned then an error has arisen, else a 
               positive number is returned.

 Availability: All AES versions.

 Group:        Application library

 See Also:     Binding   appl_init   appl_read   appl_find   Messages