Defines | |
| #define | NJB_Get_File NJB_Get_Track |
| #define | NJB_Get_File_fd NJB_Get_Track_fd |
Functions | |
| void | NJB_Reset_Get_Datafile_Tag (njb_t *njb) |
| njb_datafile_t * | NJB_Get_Datafile_Tag (njb_t *njb) |
| void | NJB_Datafile_Destroy (njb_datafile_t *df) |
| int | NJB_Send_File (njb_t *njb, const char *path, const char *name, const char *folder, NJB_Xfer_Callback *callback, void *data, u_int32_t *fileid) |
| int | NJB_Delete_Datafile (njb_t *njb, u_int32_t fileid) |
| int | NJB_Create_Folder (njb_t *njb, const char *name, u_int32_t *folderid) |
| int NJB_Create_Folder | ( | njb_t * | njb, | |
| const char * | name, | |||
| u_int32_t * | folderid | |||
| ) |
This function creates a new folder on the device, if the device supports folder creation.
| njb | a pointer to the njb_t jukebox object to use | |
| name | the name of the new folder to create | |
| folderid | a pointer to a variable that will hold the new item ID for the folder if it is successfully created. |
| void NJB_Datafile_Destroy | ( | njb_datafile_t * | df | ) |
Destroys a datafile struct.
| df | the datafile struct to destroy |
| int NJB_Delete_Datafile | ( | njb_t * | njb, | |
| u_int32_t | fileid | |||
| ) |
This deletes a datafile from the device.
| njb | a pointer to the njb_t jukebox object to use | |
| fileid | the file ID for the file to delete |
| njb_datafile_t* NJB_Get_Datafile_Tag | ( | njb_t * | njb | ) |
This gets a datafile tag from the device. The device should first be rewound using the NJB_Reset_Get_Datafile_Tag() function. The tag is newly allocated and should be destroyed with NJB_Datafile_Destroy() after use.
| njb | a pointer to the njb_t object to get datafiles from |
| void NJB_Reset_Get_Datafile_Tag | ( | njb_t * | njb | ) |
This resets the datafile metadata retrieveal function. The datafile tags can then be retrieved one by one using the NJB_Get_Datafile_Tag() function.
Typical usage:
njb_t *njb; njb_datafile_t *df;
NJB_Reset_Get_Datafile_Tag(njb);
while ( (df = NJB_Get_Datafile_Tag(njb)) != NULL ) {
// Do something with all the datafiles...
NJB_Datafile_Destroy(df);
}
| njb | a pointer to the njb_t object to reset the datafile retrieveal pointer for |
| int NJB_Send_File | ( | njb_t * | njb, | |
| const char * | path, | |||
| const char * | name, | |||
| const char * | folder, | |||
| NJB_Xfer_Callback * | callback, | |||
| void * | data, | |||
| u_int32_t * | fileid | |||
| ) |
This function sends a datafile to the device (downloads), optionally using a folder name.
| njb | a pointer to the njb_t object to send the file to | |
| path | a path to the file that shall be downloaded. | |
| name | a filename to use for this file on the device. Should only be the basename, excluding any folder name(s). | |
| folder | a folder name to use for this file on the device. Not all devices support folders, so this might be ignored. A folder name must begin and end with backslash (\) and have levels of hierarchy separated by backslashes too, like this: "\foo\bar\fnord\". | |
| callback | a function that will be called repeatedly to report progress during transfer, used for e.g. displaying progress bars. This may be NULL if you don't like callbacks. | |
| data | a voluntary parameter that can associate some user-supplied data with each callback call. It is OK to set this to NULL of course. | |
| fileid | a pointer to a variable that will hold the new file ID when the operation is finished. |
1.5.2