Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

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

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

gf_vcap_detach(), gf_vcap_disable(), gf_vcap_enable()