
(!/ /6-%-21(,$0
Appendix B
B-135
Writes data to a user’s TAG memory area then waits for it to be read by
a TAG_READ_W.
C Syntax
#include <copro.h>
unsigned TAG_WRITE (tag,offset,size,buffer,timeout)
unsigned tag;
or
char *tag;
unsigned offset;
unsigned size;
unsigned char *buffer;
unsigned timeout;
Parameters
tag
Use to access the TAG table. This can be either the symbolic TAG or
the handle returned from a TAG_LINK or TAG_DEFINE call.
offset
A byte offset from the start of the tagged area from where data will
be written.
size
Specifies the number of bytes to write to the tagged area.
buffer
Specifies the buffer to copy the write data write to the tagged area.
timeout
Timeout value in seconds (valid range 0-16383). The function will
timeout unless the TAG can be written before the timeout expires.
The TAG may not be able to be written if another process has the
TAG locked or if the corresponding TAG_READ_W from another
process has not been issued. A value of CC_FOREVER (defined in
COPRO.H) will cause this function to wait indefinitely until the
TAG can be written.
Returns
Value Symbolic Name Meaning
.$/ 1(-, 02""$00%2*
#$%(,$ -21 -% / ,&$
1 0(7$ &/$ 1$/ 1' , 1'$ + 5(+2+ **-4$#
,3 *(# 1(+$-21 3 *2$
(# ,-1 "-+.*$1$ (, 1(+$ *-")$#
(# ,-1 "-+.*$1$ (, 1(+$ 1'$ ,-1 /$ #
4/(1$ (0 */$ #6 .$,#(,& -, 1'(0
,-1 %-2,#
(0 -,*6
TAG_WRITE_W
Comentarios a estos manuales