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