1XDF_DEFINE_ARRAYS(3)       xdffileio library manual       XDF_DEFINE_ARRAYS(3)
2
3
4

NAME

6       xdf_define_arrays - Specify the number of input/output arrays
7

SYNOPSIS

9       #include <xdfio.h>
10
11       int xdf_define_arrays(struct xdf* xdf,
12                             unsigned int narrays, const size_t *strides);
13

DESCRIPTION

15       xdf_define_arrays()  specifies the number of arrays and its strides for
16       upcoming calls to xdf_write(3) and xdf_read(3) using xdf.   This  func‐
17       tion  is  used  to configure the upcoming transfer. As such, it must be
18       called before xdf_prepare_transfer(3) (calling it after will produce an
19       error).  However  the function may be called several times but only the
20       last call is meaningful for the transfer.
21
22       narrays specifies the number of arrays that will  be  provided  in  the
23       argument list of xdf_write(3) or xdf_read(3).
24
25       strides  argument should point to an array of narrays unsigned int cor‐
26       responding respectively to the stride of each arrays that will be  sup‐
27       plied  to the upcoming call to xdf_write(3) or xdf_read(3).  The stride
28       corresponds to the length in byte between two  consecutive  samples  of
29       the same channel in the array.
30

RETURN VALUE

32       xdf_define_arrays()  returns  0  in  case  of success, otherwise -1 and
33       errno is set appropriately.
34

ERRORS

36       ENOMEM The system is unable to allocate resources.
37

SEE ALSO

39       xdf_prepare_transfer(3), xdf_read(3), xdf_write(3)
40
41
42
43
44
45
46EPFL                                 2010                 XDF_DEFINE_ARRAYS(3)
Impressum