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 в качестве значения этого параметра.

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

Потоки не должны вызывать эту функцию между вызовами 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