Aim MIL-STD-1553 - Apicmdtrackscan

MIL-STD-1553 Reference Manual
133
Chapter 3 – System Functions
3.1.32 ApiCmdTrackScan
Prototype:
AiInt16 ApiCmdTrackScan ( AiUInt32 ul_ModuleHandle, AiUInt8 biu,
TY_API_TRACK_SCAN_IN x_TrackScanIn,
TY_API_TRACK_SCAN_OUT *px_TrackScanOut );
Driver Command:
API_TRACK_SCAN (0x24)
Purpose:
This function is used to read a list of all currently valid multiplex states. A multiplex
state is valid, if it had been received at least once. It is not valid, if it either was not
defined or if ApiCmdTrackRead/ApiCmdTrackReadEx was called with
“ReadMode” = API_TRACKCLR_UDF for the related mux state, and the state was
not received since then.
I
I
n
n
p
p
u
u
t
t
T
T
Y
Y
_
_
A
A
P
P
I
I
_
_
T
T
R
R
A
A
C
C
K
K
_
_
S
S
C
C
A
A
N
N
_
_
I
I
N
N
x
x
_
_
T
T
r
r
a
a
c
c
k
k
S
S
c
c
a
a
n
n
I
I
n
n
Track scan structure
typedef struct ty_api_track_scan_in
{
AiUInt32 ul_TrackId;
AiUInt32 ul_ChunkNb;
AiUInt32 ul_ChunkSize;
} TY_API_TRACK_SCAN_IN;
A
A
i
i
U
U
I
I
n
n
t
t
3
3
2
2
u
u
l
l
_
_
T
T
r
r
a
a
c
c
k
k
I
I
d
d
Value
Description
0..255
Track Multiplex Buffer Identifier
A
A
i
i
U
U
I
I
n
n
t
t
3
3
2
2
u
u
l
l
_
_
C
C
h
h
u
u
n
n
k
k
N
N
b
b
Value
Description
0..n
The chunk number to read, when more multiplex states
are available than wanted to be read. The number of
states wanted to be read is given with parameter
‘ul_ChunkSize’.
Example:
Available multiplex states = 35
ul_ChunkNb = 0
ul_ChunkSize = 16
 Function returns the first 16 multiplex states (1..16) and ul_MoreData = 1
ul_ChunkNb = 1
ul_ChunkSize = 16
 Function returns the second 16 multiplex states (17..32) and ul_MoreData = 1
ul_ChunkNb = 2
ul_ChunkSize = 16
 Function returns the third 16 multiplex states (only 33..35 are valid, 36..48 are set to
0xFFFF) and ul_MoreData = 0
A
A
i
i
U
U
I
I
n
n
t
t
3
3
2
2
u
u
l
l
_
_
C
C
h
h
u
u
n
n
k
k
S
S
i
i
z
z
e
e