capture_update()

Update the video capture device.

Synopsis:

#include <vcapture/capture.h>

int capture_update( capture_context_t context,
    uint32_t flags )

Arguments:

context
Pointer to the video capture context.
flags
Reserved. Do not use.
value
A pointer to the location where the retrieved property is located.

Library:

libcapture

Description:

The function capture_update() applies (commits) all updates posted since it was last called to the driver.

Functions such as capture_set_property_i() and capture_set_property_p() update memory but they don't apply updates to the video capture device. To apply updates, you must call capture_update(). This behavior allows the proper combining of discrete properties, such as *DST_X, *DST_Y and *DST_WIDTH. Once these properties are combined, a call to capture_update() commits all the changes to the device at the same time.

If you want video capture to start immediately, set CAPTURE_ENABLE to 1 (one) when you call capture_update().

Returns:

≥0
Success
-1
An error occurred (errno is set).

Errors:

EINVAL
Some parameters are in conflict; video capture isn't possible.
EIO
Hardware input or output error.
ENODEV
No video capture device with the specified device ID.
Note: The driver may slog*() more detailed error information. Use sloginfo to retrieve it.