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

See also:

gf_display_attach(), gf_display_query_mode(), gf_display_set_mode()