224
Reference Manual AFDX / ARINC 664 Application Interface Library
Section 4 – Function Reference: Target Independent Administration Functions
4
4
.
.
5
5
.
.
9
9
F
F
d
d
x
x
C
C
r
r
e
e
a
a
t
t
e
e
R
R
e
e
c
c
I
I
n
n
d
d
e
e
x
x
Prototype:
AiReturn FdxCreateRecIndex(const AiChar *ac_RecordingFile,
const AiChar *ac_IndexFile,
PFN_FDXCREATEINDEX_CALLBACK
pfnCreateIndexCallback,
AiUInt32 ul_Granularity)
Driver Command
none
Purpose:
This function creates an index that corresponds to a recording file. The index can later be used
to locate frames more easily. The index can either be written into a separate file or appended to
the recording file.
Writing an index can take a lot of time. To visualize the progress and to give the user the the
abilitity to abort the process, a callback function can be applied.
This function can also be performed on a recording file, that already contains index
informations from a previous call to this function.
Input:
AiChar *ac_RecordingFile
The name of the recording file produced by FdxCmdMonQueueControl.
Note for remote recording:
To use this function direct access to the recording file is required. This can be
achived by mounting the directory as network drive (Operating System
functionality). The recording file is generated always locally on the server
(where the fdx board is present). The FdxCreateRecIndex function does not use
functionality of ANS to access the recording file.
AiChar *ac_IndexFile
The name of the index file to be produced. If ac_IndexFile is identical to
ac_RecordingFile, the index table will be written to the end of the recording file.
P
P
F
F
N
N
_
_
F
F
D
D
X
X
C
C
R
R
E
E
A
A
T
T
E
E
I
I
N
N
D
D
E
E
X
X
_
_
C
C
A
A
L
L
L
L
B
B
A
A
C
C
K
K
p
p
f
f
n
n
C
C
r
r
e
e
a
a
t
t
e
e
I
I
n
n
d
d
e
e
x
x
C
C
a
a
l
l
l
l
b
b
a
a
c
c
k
k
typedef AiBoolean (*PFN_FDXCREATEINDEX_CALLBACK)
(AiUInt32 ul_Percent, const AiChar *ac_RecordingFile,
const AiChar *ac_IndexFile);
The address of a function which allows to display the index creation process or to
abort the index creation. Returns TRUE on User-Abort, FALSE otherwise. Called
whenever the percentage changes and the percentage is a multiple of
ul_Granularity.
The recording and index filename will be passed over to the callback function.
These informations can be used to identify the caller in multithreaded applications.
