This function is displayed as a function pointer in rts_glue_funcs when a data frame is read from RTS SDK.
int (* read)( struct **frame, void *handle );
|frame||The location where the returned audio and video frames are stored.|
|handle||The handle that is returned when the open function is called.|
- If 1 is returned, one data frame is read.
- If 0 is returned, the system tries again later.
- If -1 is returned, end-of-file (EOF) occurs. That is, no more data can be read.
- If negative numbers except -1 are returned, severe errors occur.
If 1 is returned, the returned frame must be released by the caller. Sample code:
struct rts_frame *f = NULL; int r = __rts_funcs->read(&f, handle); ... if(f ! = NULL) f->free_ptr(f);