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

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

EtherSpaceLink-RG408
EtherSpaceLink family User Manual
14. 6 . 20 .
EtherSpaceLink_get_number_of_links()
S ynops i s
int EtherSpaceLink_get_number_of_links ( EtherSpaceLink ESL_unit
)
D esc ri pt i on
EtherSpaceLink_get_number_of_links()
dete r m i nes h ow m a n y S p ac e W ir e po r ts
( i .e.
c o
nne
c
t
o
r s )
a
r e
p
r esent
o
n t
h
e
u
n i t.
R e ca ll , f o r a n E t h e rS p ac eL i n k ( E S L ) u n i t , t ha t o n ly o ne po r t m a y be ac t iv a ted a t a n y t i me , e v en t h ou g h
i ts
ha
r d w
a
r e pl
a
t
f
o r m m
a
y
ha
v e e ig
h
t S p
ac
e
W
ir e
c
o nne
c
t o r s.
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.
Retu r ns
≥ 1 Th e n u mbe r o f po r ts o n t h i s u n i t
-
1
A
n e rr o r o
cc
u rr ed
Note
B
e
a w a
r e t
ha
t
EtherSpaceLink_get_number_of_links()
s
h oul
d
o
n
ly
be
ca ll
ed
a
t t
h
e st
a
r t
o f
a n A P I p r o gr a m , be f o r e t h e S p ac e W ir e l i n k (s ) a r e en a b l ed. S ee se c t i o n 1 4 . 5 .3 , “ A s y n ch r o n ou s Iss u es
d
u
ri n g S t
a
t
u
s
Poll
i n g
”
,
E xa mple
int Nlinks;
EtherSpaceLink ESL_unit;
ESL_unit = EtherSpaceLink_open ( "192.168.3.40" );
Nlinks = EtherSpaceLink_get_number_of_links ( ESL_unit );
4Links Limited
www.4Links.co.uk
support@4Links.co.uk
page 81 of 110
T +44 1908 642001; F +44 1908 363463
Milton Keynes MK3 6EB, UK
Suite EU2, Bletchley Park