capture_set_property_p()

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.