summaryrefslogtreecommitdiff
path: root/pjmedia/include/pjmedia/vid_port.h
diff options
context:
space:
mode:
Diffstat (limited to 'pjmedia/include/pjmedia/vid_port.h')
-rw-r--r--pjmedia/include/pjmedia/vid_port.h12
1 files changed, 9 insertions, 3 deletions
diff --git a/pjmedia/include/pjmedia/vid_port.h b/pjmedia/include/pjmedia/vid_port.h
index 3de28346..0d5e3d84 100644
--- a/pjmedia/include/pjmedia/vid_port.h
+++ b/pjmedia/include/pjmedia/vid_port.h
@@ -78,17 +78,23 @@ typedef struct pjmedia_vid_port pjmedia_vid_port;
PJ_DECL(void) pjmedia_vid_port_param_default(pjmedia_vid_port_param *prm);
/**
- * Create a video port with the specified parameter.
+ * Create a video port with the specified parameter. Video port may open
+ * the video stream with different parameter than the requested values in
+ * the \a prm.vidparam argument. Application can check the the values in
+ * the \a prm.vidparam argument to see if they have changed.
*
* @param pool Pool to allocate memory from.
- * @param prm The video port parameter.
+ * @param prm On input, it specifies the video port parameters
+ * to be used. On output, prm.vidparam will be set to
+ * the actual video device parameters used to open the
+ * stream.
* @param p_vp Pointer to receive the result.
*
* @return PJ_SUCCESS if video port has been created
* successfully, or the appropriate error code.
*/
PJ_DECL(pj_status_t) pjmedia_vid_port_create(pj_pool_t *pool,
- const pjmedia_vid_port_param *prm,
+ pjmedia_vid_port_param *prm,
pjmedia_vid_port **p_vp);
/**