Name
SendIPCMessage -- send a message to an IPC port (V9.0)
Synopsis
int ok = SendIPCMessage(STRPTR port, UBYTE *data, int len,
             struct hwTagList *tags);
Function
This function has to send the message specified by data to the IPC port specified by port. The length of the message specified by data is specified in the len parameter (in bytes). Note that data could also contain binary data. If the port name specified in port doesn't exist or an error occurs, SendIPCMessage() must return False.

Note that since SendIPCMessage() may be used to send messages to different processes, the receiver's port must be specified as a string instead of a handle created by CreateIPCPort() because handles are of course private to the process that created them.

When an IPC port receives a message, it should post it to Hollywood's event queue using the HWEVT_USERMESSAGE event type. See hw_PostEvent for details.

Inputs
port
receiver's port name
data
raw data to send to port
len
length of the data to send to port
tags
reserved for future use, currently always NULL
Results
ok
return True to indicate success, False for error

Show TOC