njb_replace_track_tag(3)

NAME

NJB_Replace_Track_Tag - replace a track tag on the jukebox

LIBRARY

libnjb

SYNOPSIS

#include <sys/types.h> #include <libnjb.h>
extern int njb_error
int  NJB_Replace_Track_Tag (njb_t *njb, u_int32_t trackid,
const char *codec, const char *title, const  char  *album,  const
char  *genre,  const  char  *artist,  u_int32_t length, u_int32_t
tracknum, u_int32_t  filesize,  const  char  *fname,  const  char
*year, int protected)

DESCRIPTION

This function replaces the tag for track trackid on the

NJB. The codec parameter is required, and cannot be NULL, since

it tells the NJB what audio format the song track is stored in.

The title, album, genre, artist, length , tracknum , filesize ,

fname, year, and protected parameters are optional, and can be

NULL (pointers) or 0 (integers). However, as the NJB organizes

tracks by artist, album, title and genre, is is strongly recom

mended that these parameters be provided.

This function increments the NJB's library counter, pro

vided it has not been incremented previously during the session.

RETURN VALUES

If the transfer is successful, NJB_Replace_Track_Tag re

turns 0. Otherwise, -1 is returned and njb_error is set.

EO_BADCOUNT

The library counter on the NJB could not be up

dated. The tag replacement was successful.

EO_BADDATA

songtag contains invalid data or is not properly

formed.

EO_BADSTATUS

A non-zero status was returned by the NJB during

the communcation.

EO_INVALID

A required parameter was NULL.

EO_NOMEM There was not enough memory to create the "tag"

for the audio track.

EO_RDSHORT

The NJB sent fewer bytes than expected on the

bulk data pipe.

EO_TIMEOUT

The NJB did not verify that the transfer was

complete after several queries. The tag may have still have been

replaced successfully.

EO_USBBLK An I/O error occurred on the bulk data pipe.

EO_USBCTL An I/O error occurred on the control pipe.

EO_WRSHORT

Fewer bytes than requested were written to the

USB pipe.

EO_XFERERROR

The NJB returned a non-zero status when the tag

for the track was transferred.

SEE ALSO

NJB_Send_Track(3), NJB_Get_Track(3), songid(3)

January 2003 NJB_RE

PLACE_TRACK_TAG(3)