User`s guide

SdfCommentWrite
Syntax long SdfCommentWrite (short fn, short commNo, long offset, long size, char far *buf);
Returns a long integer of greater than or equal to minus one. The return value is the number
of characters of comment actually written; a return of
−1 indicates an error.
This function writes a character array to the comment area in an open SDF file, where buf is the pointer to
the array, and fn is the number of the open SDF file (for details, see SdfOpen).
The commNo parameter selects the comment header to which you want to write. Most instruments have
only one comment header, so you will usually specify 0 (zero), which selects the first comment.
The offset parameter is the number of characters to skip before writing the data. One situation where an
offset is useful is if you are writing data in multiple passes. If you don’t want to use an offset, specify an
offset of zero.
The size parameter is the maximum number of characters you want to write. This function returns the
actual number of characters that you wrote. Since the comment area is a fixed size (fixed at the time of
file creation) you may not be able to write the number of characters specified.
This function automatically updates the comment size in the appropriate SDF_COMMENT_HDR.
Using SDF Data with C Programs
SdfCommentWrite
6-22