gf_layer_query()

Запрос функциональных возможностей со слоем

Прототип:

#include <gf/gf.h>
int gf_layer_query( gf_layer_t layer,
int format_index,
gf_layer_info_t *info );

Аргументы:

layer
Дескриптор слоя для запроса перечня функций, возвращенный функцией gf_layer_attach().
format_index
Индекс запрашиваемого формата слоя, имеент целочисленное значение, начиная с 0.
info
Адрес структуры gf_layer_info_t, в которую будет сохранена информация о слое. Нельзя указывать NULL в качестве значения этого параметра.

Библиотека:

gf

Описание:

Функция запрашивает параметры слоя layer для указанного индекса формата и заполняет структуру info. Обычно в цикле обрабатываются все индексы, начиная с 0, пока не будет найден искомый format, либо возвращенное значение не будет отлично от GF_ERR_OK.


Warning: Потоки не должны вызывать эту функцию между вызовами gf_draw_begin() и gf_draw_end(). В противном случае возможна взаимная блокировка потоков.

Возвращаемое значение:

GF_ERR_OK
Успешное завершение.
GF_ERR_IODISPLAY
Ошибка коммуникации с io-display. Следует проверить запущен ли в настоящий момент сервер io-display. Вывод sloginfo может содержать дополнительную информацию.
GF_ERR_PARM
Был передан недопустимый параметр или обнаружена внутренняя ошибка согласованности, например недопустимый номер дисплея, либо значение параметра layer или info равно NULL
GF_ERR_NOSUPPORT
Был передан индекс формата, выходящий за пределы допустимого диапазона для данного слоя.

Классификация:

Графическая подсистема ЗОСРВ «Нейтрино», Graphics Framework

Обработчик прерываний
Нет
Обработчик сигналов
Нет
В потоке
Да

Тематические ссылки:

gf_display_attach(), gf_layer_detach(), gf_layer_disable(), gf_layer_enable(), gf_format_t




Предыдущий раздел: GF API