pjsua_vid_dev_set_setting method

int pjsua_vid_dev_set_setting(
  1. int id,
  2. int cap,
  3. Pointer<Void> pval,
  4. int keep,
)

Configure the capability of a video capture device. If the device is currently active (i.e. if there is a video call using the device or a video preview has been started), the function will forward the setting to the video device instance to be applied immediately, if it supports it.

The setting will be saved for future opening of the video device, if the "keep" argument is set to non-zero. If the video device is currently inactive, and the "keep" argument is false, this function will return error.

Note: This function will only works for video capture devices. To configure the setting of video renderer device instances, use pjsua_vid_win API instead.

Warning: If application refreshes the video device list, it needs to manually update the settings to reflect the newly updated video device indexes. See #pjmedia_vid_dev_refresh() for more information.

See also pjmedia_vid_stream_set_cap() for more information about setting a video device capability.

@param id The video device index. @param cap The video device capability to change. @param pval Pointer to value. Please see #pjmedia_vid_dev_cap documentation about the type of value to be supplied for each setting. @param keep (see description)

@return PJ_SUCCESS on success or the appropriate error code.

Implementation

int pjsua_vid_dev_set_setting(
  int id,
  int cap,
  ffi.Pointer<ffi.Void> pval,
  int keep,
) {
  return _pjsua_vid_dev_set_setting(
    id,
    cap,
    pval,
    keep,
  );
}