User Guide

Ampex 1308911-02 5-13
libdd2 API Functions dst_convpos
5.4 dst_convpos
NAME
dst_convpos() - convert tape position from structure form to token form or token form to
structure form.
SYNOPSIS
#include <dd2.h>
int dst_convpos(int fd, dst_convpos_st *pos);
DESCRIPTION
dst_convpos() converts a tape position from one form to another; i.e., from token to structure
or structure to token. See the ““DST API Overview” on page 5-1 for information on position
specifications, including: form, format, typedef enumerations (definitions), unions, structures,
and tokens.
dst_convpos() is available to all users.
PARAMETERS
fd The file descriptor returned by the open call.
*pos Pointer to a structure of type
dst_convpos_st.
USAGE
dst_convpos() uses the *pos structure for both input and output. On input, the srcpos union
provides the source (input) position specification and the
source/dest members provide
definitions for the conversion. On return, the
destpos union provides the destination
(converted) position specification.