gf_vcap_attach()

Attach to a video capture unit

Synopsis:

#include <gf/gf.h>

int gf_vcap_attach ( gf_vcap_t *    pvcap,
                     gf_dev_t       gdev,
                     unsigned       vcap_index,
                     unsigned       flags );

Arguments:

pvcap

An address in which the function stores a handle to the video capture unit.

gdev

The handle of the graphics device.

vcap_index

Index of the desired video capture unit (units are indexed numerically starting at 0).

flags

Flags to control behavior; currently no flags are defined.

Library:

gf

Description:

This function attaches to a video capture unit.

Returns:

The status of the attach:

GF_ERR_OK

Success

GF_ERR_MEM

Memory-allocation failure

GF_ERR_PARM

The layer index is out of range for the specified display.

GF_ERR_IODISPLAY

Error communicating with io-display. Check to ensure io-display is still running. The sloginfo utility may provide more information.

Classification:

QNX Graphics Framework

See also:

gf_vcap_detach(), gf_vcap_disable(), gf_vcap_enable()