gf_surface_sidlist()

Функция возвращает список созданных поверхностей и их параметры

Прототип:

#include <gf/gf.h>
unsigned gf_surface_sidlist( gf_dev_t gdev,
gf_sidlist_t *list,
unsigned nitems );

Аргументы:

gdev
Дескриптор графического устройства, полученный с помощью вызова функции gf_dev_attach().
list
Указатель на созданный массив структур типа gf_sidlist_t, предназначенный для хранения информации о поверхностях.
nitems
Количество элементов в массиве структур list, характеризующее размерность массива (используется в случае, если list не равен NULL).

Библиотека:

gf

Описание:

В случае, если указатель list равен NULL, функция возвращает общее количество обслуживаемых менеджером io-display поверхностей. Это число обычно используется для выделения памяти для массива структур list перед запросом информации о поверхностях при повторном вызове функции gf_surface_sidlist(). Если указатель list не равен NULL, функция возвращает заполненный массив структур типа gf_sidlist_t.

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

0
Общее количество обслуживаемых менеджером io-display поверхностей равно 0, либо возникла ошибка в процессе взаимодействия с менеджером io-display, либо значение параметра gdev равно NULL
!0
Общее количество обслуживаемых менеджером io-display поверхностей, если казатель list равен NULL. Если указатель list не равен NULL, возвращаемое значение соответствует числу заполненных элементов массива.

Примеры использования:

unsigned nitems;
gf_sidlist_t *list;
nitems = gf_surface_sidlist( gdev, NULL, 0 );
list = (gf_sidlist_t *)malloc( nitems * sizeof( gf_sidlist_t ) );
if ( list == NULL )
{
printf( "malloc() failed\n" );
return (-1);
}
if ( gf_surface_sidlist( gdev, list, nitems ) != nitems )
{
printf( "gf_surface_sidlist() failed\n" );
return (-1);
}

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

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

Поддерживается, начиная с ЗОСРВ «Нейтрино» редакции 2020

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

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

gf_sidlist_t, gf_dev_attach()




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