Set video frame capture properties.
Synopsis:
#include <vcapture/capture.h>
int capture_set_property_p( capture_context_t context, uint32_t prop, int32_t *value )
Arguments:
- context
- Pointer to the video capture context.
- prop
- The video capture frame property to set.
- *value
- Pointer to the array with the property to set.
Library:
libcapture
Description:
The function
capture_set_property_p() passes the pointer to the array of video capture
properties to the video capture library.
Array resources, such as CAPTURE_PROPERTY_FRAME_FLAGS and
CAPTURE_PROPERTY_FRAME_SEQNO, are not allocated by default. They need to be set, then
passed to the video capture driver. To do this, you must set the properties you need to specify by
calling capture_set_property_i(), then pass a pointer to the array with these
properties by calling capture_set_property_p().
Note: Allocate an array large enough to store the video capture properties. The minimum
number of elements in the array must be at least as large as the corresponding capture property
associated with the array you are setting. For example, the minimum array sizes of
CAPTURE_PROPERTY_FRAME_SEQNO and CAPTURE_PROPERTY_FRAME_FLAGS are
determined by the size of CAPTURE_PROPERTY_NBUFFER.
Returns:
- 0
- Success.
- -1
- An error occurred (errno is set).
Errors:
- EINVAL
- Bad value or values.
- ENOENT
- The specified property can't be set by this method.
- ENOTSUP
- The driver or the device doesn't support the specified property.
- EROFS
- Unable to change read-only property.