4Links EtherSpaceLink Series, Руководство пользователя

Страница: 73 / 110

EtherSpaceLink-RG408
EtherSpaceLink family User Manual
14. 6 .14. EtherSpaceLink_read_packet_full_nowait()
S ynops i s
int EtherSpaceLink_read_packet_full_nowait
( EtherSpaceLink ESL_unit,
void * buffer,
int length,
int * terminator,
int special_action
)
D esc ri pt i on
Th
i s
f u
n
c
t i
o
n i s s i m i
l a
r t
o
EtherSpaceLink_read_packet_full()
, e x
c
e
p
t t
ha
t t
h
e r e
a
d
r e q u est i s r u n a s a c o n c u rr ent p r o c ess ( u s i n g P O S I X t h r e a ds ) a nd t h i s p r o c ed u r e r et u r ns i mmed i a te ly ,
a llow
i n g t
h
e
u
se r
p
r
o
gr
a
m t
o c o
nt i n
u
e
a
t t
h
e s
a
me t i me
a
s t
h
e
p ac k
et i s be i n g r e
c
e iv ed.
Th
e
p
r
o
gr ess
o f t h e r e a d m a y be dete r m i ned w i t h
EtherSpaceLink_read_packet_status()
, o r t h e u se r
p
r
o
gr
a
m
ca
n
w a
i t
f o
r t
h
e r e
a
d t
o f
i n i s
h
b
y ca ll
i n g
EtherSpaceLink_read_packet_wait_for_completion()
.
I nput p ara mete r s
ESL_unit
t h e ha nd l e r et u r ned b y a s u cc ess f ul
EtherSpaceLink_open()
c o mm a nd.
buffer
a
b
u ff
e r t
o c o
nt
a
i n r e
c
e iv ed d
a
t
a
.
length
t h e s i z e o f t h e r e c e iv e b u ff e r .
special_action
w ha t t o d o i f a “s p e c i a l” p ac k et i s r e c e iv ed.
I
f
o ne o
f
t
h
ese
ac
t i o ns i s n o t s p e
c
i
f
i ed , t
h
o se p
ac
k ets w i ll be d i s
ca
r ded.
EtherSpaceLink_
DISCARD_SPECIAL_DATA
I g n
o
r e
a
n
y
s
p
e
c
i
a l
d
a
t
a p ac k
ets.
EtherSpaceLink_
REPORT_SPECIAL_DATA
R et
a
i n t
h
e s
p
e
c
i
a l
d
a
t
a p ac k
et i n
a
b
u ff
e r
a
nd r e
po
r t i ts
l
en g t
h
.
EtherSpaceLink_
RETURN_SPECIAL_DATA
D e
l
iv e r t
h
e s
p
e
c
i
a l
d
a
t
a
i n t
h
e giv en b
u ff
e r .
EtherSpaceLink_
CALLBACK_SPECIAL_DATA
Ca ll t h e r e gi ste r ed ca ll b ac k p r o c ed u r e t o ha nd l e t h e
s p e c i a l d a t a b u ff e r . I f n o s u ch ca ll b ac k p r o c ed u r e ha s
been r e gi ste r ed , t h en d i s ca r d t h e s p e c i a l d a t a p ac k et.
S ee
EtherSpaceLink_read_packet_special_
callback()
.
4Links Limited
www.4Links.co.uk
support@4Links.co.uk
page 73 of 110
T +44 1908 642001; F +44 1908 363463
Milton Keynes MK3 6EB, UK
Suite EU2, Bletchley Park