Aim MIL-STD-1553 - Apicmdtrackprealloc

MIL-STD-1553 Reference Manual
126
Chapter 3 – System Functions
3.1.29 ApiCmdTrackPreAlloc
Prototype:
AiInt16 ApiCmdTrackPreAlloc ( AiUInt32 ul_ModuleHandle, AiUInt8 biu,
TY_API_TRACK_PREALLOC_IN x_TrackPreAllocIn,
TY_API_TRACK_PREALLOC_OUT *px_TrackPreAllocOut );
Driver Command:
API_TRACK_PREALLOC (0x23)
Purpose:
This function is used to pre-allocate the memory of a list of multiplex states. This
function may be used more than once to pre-allocate different multiplex states. This
function is only useful, if a track was previously defined in ApiCmdTrackDefEx() with
parameter ‘ul_MultiplexedTrackNb’ set to 0 (dynamic memory allocation).
Note: After calling this function the dynamic memory allocation is disabled, this
means that other multiplex states that are not pre-allocated with this function
will not be stored.
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
_
_
P
P
R
R
E
E
A
A
L
L
L
L
O
O
C
C
_
_
I
I
N
N
x
x
_
_
T
T
r
r
a
a
c
c
k
k
P
P
r
r
e
e
A
A
l
l
l
l
o
o
c
c
I
I
n
n
Track pre-allocate structure
typedef struct ty_api_track_prealloc_in
{
AiUInt32 ul_TrackId;
AiUInt32 ul_PreAllocNb;
AiUInt32 *pul_MuxStates;
} TY_API_TRACK_PREALLOC_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
_
_
P
P
r
r
e
e
A
A
l
l
l
l
o
o
c
c
N
N
b
b
Value
Description
0..n
The number of mux states where the memory shall be
pre-allocated
A
A
i
i
U
U
I
I
n
n
t
t
3
3
2
2
*
*
p
p
u
u
l
l
_
_
M
M
u
u
x
x
S
S
t
t
a
a
t
t
e
e
s
s
List of multiplex states where the data buffer memory shall be pre-allocated.
Note: It is the responsibility of the user application that this list is of the size given with
parameter ‘ul_PreAllocNb’