gf_display_query()

Query the current display mode

Synopsis:

#include <gf/gf.h>

int gf_display_query( gf_dev_t           gdev,
                      unsigned           display_index,
                      gf_display_info_t *info );

Arguments:

gdev
The handle for the graphics device to query. This is the handle acquired by gf_dev_attach().
display_index
The index of the desired display. A graphics device can have one or more displays, with the index starting at 0.
info
A pointer to a gf_display_info_t structure that the function fills in with information about the display (see below).

Library:

gf

Description:

This function queries the current mode of the display specified by display_index on a graphics device. A device typically drives one display, although some hardware is fitted with multiple displays, each of which you can query to via this function.

The info argument contains information about the attached display. See gf_display_info_t in gf_display_attach() for a description of this structure.

Returns:

GF_ERR_OK
Success.
GF_ERR_MEM
Memory allocation failure.
GF_ERR_IODISPLAY
Could not access the /dev/io-display directory. Check to ensure that io-display is running. The sloginfo utility may provide more information.
GF_ERR_PARM
The display index is out of bounds.
GF_ERR_CFG
Badly configured display; check the io-display configuration file.

Classification:

QNX Graphics Framework

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

gf_display_attach(), gf_display_query_mode(), gf_display_set_mode()