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

Безопасность использования

Обработчик прерываний

Нет

Обработчик сигналов

Нет

В потоке

Да

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

gf_sidlist_t, gf_dev_attach()

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