rd_audioinfo — Rivendell Audio Info C Library Function
#include <rivwebcapi/rd_audioinfo.h>
int RD_AudioInfo( | audioinfo[], | |
hostname[], | ||
username[], | ||
passwd[], | ||
ticket[], | ||
cartnumber, | ||
cutnumber, | ||
user_agent[], | ||
numrecs) ; |
struct rd_audioinfo * audioinfo[]
;const char hostname[]
;const char username[]
;const char passwd[]
;const char ticket[]
;const unsigned cartnumber
;const unsigned cutnumber
;const char user_agent[]
;unsigned * numrecs
;RD_AudioInfo is the function to use to get information about an entry in the audio store.
Table 1. RD_AudioInfo function call fields
FIELD NAME | FIELD TYPE | MEANING | REMARKS |
---|---|---|---|
*rd_audioinfo | Pointer to rd_audioinfo structure | Memory location to store specific audioinfo data | Mandatory |
hostname | Character Array | Name Of Rivendell DB Host | Mandatory |
username | Character Array | Rivendell User Name | Mandatory When NO Ticket Provided |
passwd | Character Array | Rivendell User Password | Mandatory When NO Ticket Provided |
ticket | Character Array | Rivendell Authentification Ticket | Mandatory When NO User/Password Pair Provided. |
cartnumber | unsigned integer | Cart Number | Mandatory |
cutnumber | unsigned integer | Cut Number | Mandatory |
user_agent | Character Array | User Agent Value put into HTTP request | Optional (default is Rivendell-C-API/x.x.x) |
*numrecs | pointer to integer | memory location for number of records returned | Mandatory |
When successful function will return the number of records sent (numrecs) and a rd_audioinfo structure which is stored in the provided memory locations. The rd_audioinfo structure has the following fields:
struct rd_audioinfo { unsigned cart_number; /* Cart Number */ unsigned cut_number; /* Cut Number */ int format; int channels; int samplerate; unsigned frames; unsigned length; };