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

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

gf_dev_attach()