WORD appl_write( ap_id, length, msg )
WORD ap_id, length;
VOIDP msg;
appl_write() can be used to send a message to a valid message pipe.
Opcode
12 (0x0C)
Availability
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 (
10) messages to the desktop to trigger desktop functions.
As of
AES version 4.00 you can use
shel_write() with
mode=
SWM_BROADCAST (
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