Ignore:
Timestamp:
Sep 20, 2011 10:07:55 AM (10 years ago)
Author:
bennylp
Message:

Related to preview (re #1340): handle problems with starting or stopping preview during a call

File:
1 edited

Legend:

Unmodified
Added
Removed
  • pjproject/trunk/pjmedia/include/pjmedia-videodev/videodev.h

    r3756 r3758  
    221221    pjmedia_dir dir; 
    222222 
    223     /** Specify whether the device supports callback */ 
     223    /** 
     224     * Specify whether the device supports callback. Devices that implement 
     225     * "active interface" will actively call the callbacks to give or ask for 
     226     * video frames. If the device doesn't support callback, application 
     227     * must actively request or give video frames from/to the device by using 
     228     * pjmedia_vid_dev_stream_get_frame()/pjmedia_vid_dev_stream_put_frame(). 
     229     */ 
    224230    pj_bool_t has_callback; 
    225231 
     
    642648 
    643649/** 
     650 * Query whether the stream has been started. 
     651 * 
     652 * @param strm      The video stream 
     653 * 
     654 * @return          PJ_TRUE if the video stream has been started. 
     655 */ 
     656PJ_DECL(pj_bool_t) pjmedia_vid_dev_stream_is_running(pjmedia_vid_dev_stream *strm); 
     657 
     658 
     659/** 
    644660 * Get the event publisher object for the video stream. Caller typically use 
    645661 * the returned object to subscribe or unsubscribe events from the video 
     
    653669pjmedia_vid_dev_stream_get_event_publisher(pjmedia_vid_dev_stream *strm); 
    654670 
    655 /* Get/put frame API for passive stream */ 
     671 
     672/** 
     673 * Request one frame from the stream. Application needs to call this function 
     674 * periodically only if the stream doesn't support "active interface", i.e. 
     675 * the pjmedia_vid_dev_info.has_callback member is PJ_FALSE. 
     676 * 
     677 * @param strm      The video stream. 
     678 * @param frame     The video frame to be filled by the device. 
     679 * 
     680 * @return          PJ_SUCCESS on successful operation or the appropriate 
     681 *                  error code. 
     682 */ 
    656683PJ_DECL(pj_status_t) pjmedia_vid_dev_stream_get_frame( 
    657684                                            pjmedia_vid_dev_stream *strm, 
    658685                                            pjmedia_frame *frame); 
    659686 
     687/** 
     688 * Put one frame to the stream. Application needs to call this function 
     689 * periodically only if the stream doesn't support "active interface", i.e. 
     690 * the pjmedia_vid_dev_info.has_callback member is PJ_FALSE. 
     691 * 
     692 * @param strm      The video stream. 
     693 * @param frame     The video frame to put to the device. 
     694 * 
     695 * @return          PJ_SUCCESS on successful operation or the appropriate 
     696 *                  error code. 
     697 */ 
    660698PJ_DECL(pj_status_t) pjmedia_vid_dev_stream_put_frame( 
    661699                                            pjmedia_vid_dev_stream *strm, 
Note: See TracChangeset for help on using the changeset viewer.