1AFREADMISC(3)                                                    AFREADMISC(3)
2
3
4

NAME

6       afReadMisc, afWriteMisc, afSeekMisc - access miscellaneous metadata in
7       an audio file
8

SYNOPSIS

10       #include <audiofile.h>
11
12       int afReadMisc (AFfilehandle file, int miscid, void *buffer, int nbytes);
13
14       int afWriteMisc (AFfilehandle file, int miscid, const void *buffer, int nbytes);
15
16       int afSeekMisc (AFfilehandle file, int miscid, int offbytes);
17

DESCRIPTION

19       afReadMisc reads up to nbytes from the miscellaneous data chunk
20       identified by miscid in file.
21
22       afWriteMisc writes up to nbytes to the miscellaneous data chunk
23       identified by miscid in file.
24
25       afSeekMisc changes the current offset within the miscellaneous data
26       chunk identified by miscid to the offset offbytes.
27

RETURN VALUE

29       afReadMisc returns the number of bytes read from the specified
30       miscellaneous chunk into the buffer referred to by buffer.
31
32       afWriteMisc returns the number of bytes written to the specified
33       miscellaneous chunk from the buffer referred to by buffer.
34
35       afSeekMisc returns the new location of the logical data pointer as
36       measured as an offset in bytes from the beginning of the miscellaneous
37       chunk’s data area.
38

ERRORS

40       afReadMisc, afWriteMisc, and afSeekMisc can produce the following error
41       codes:
42
43       •    AF_BAD_READ
44
45       •    AF_BAD_WRITE
46
47       •    AF_BAD_MISCSEEK
48
49       •    AF_BAD_MISCID
50
51       •    AF_BAD_TRACKID
52
53       •    AF_BAD_FILEHANDLE
54

AUTHOR

56       Michael Pruett <michael@68k.org>
57
58
59
60Audio File Library 0.3.6          03/06/2013                     AFREADMISC(3)