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

gf_dev_get_error()

Return the last GF error code

Synopsis:

#include <gf/gf.h>

int gf_dev_get_error( gf_dev_t gdev );

Arguments:

gdev

The handle for the graphics device to query. This is the handle acquired by gf_dev_attach().

Library:

gf

Description:

This function returns the last error code logged by a GF API call for the calling thread, providing additional information about the failure. This function resets the error indicator for the calling thread.

Possible GF error codes are:

GF_ERR_OK

no error

GF_ERR_MEM

memory allocation error

GF_ERR_IODISPLAY

error accessing io-display

GF_ERR_DEVICE

error accessing device

GF_ERR_SHMEM

error accessing shared memory

GF_ERR_DLL

error accessing dll/entrypoints

GF_ERR_THREAD

thread registration failure

GF_ERR_PARM

invalid parameter

GF_ERR_INUSE

resource in use

GF_ERR_NOSUPPORT

unsupported operation

GF_ERR_CFG

bad configuration

GF_ERR_NOLOCK

hardware isn't locked

Returns:

A value reflecting the last error logged. A value of GF_ERR_OK indicates that there have been no errors logged since the connection was established or since the last time the thread called gf_dev_get_error().

Classification:

QNX Graphics Framework

See also:

gf_dev_attach()