screen_get_windows_list()

Возвращает количество и массив доступных окон для конкретного pid или для всех процессов

Прототип:

#include <screen/screen.h>
 
int screen_get_windows_list( screen_context_t ctx,
                             pid_t            pid,
                             int              *win_count,
                             void             **windows );

Аргументы:

ctx

Дескриптор контекста, определяющий соединение с оконной подсистемой Screen. Контекст должен быть предварительно создан с помощью функции screen_create_context(). Контекст должен быть привилегированным.

pid

Process ID приложения, окна которого необходимы. Если данный параметр равен 0, запрашивается информация обо всех доступных окнах.

win_count

Указатель на int, содержащий количество запрашиваемых окон. При первом вызове данной функции следует передать 0 в качестве значения, на которое ссылается указатель, для получения реального количества окон.

windows

Указатель на void *, содержащий массив окон. При первом вызове данной функции следует передать NULL в качестве значения, на которое ссылается указатель, так как без знания фактического количества окон этот параметр не заполняется.

Библиотека:

libscreen

Описание:

Тип функции: Исполняемые немедленно

Функция позволяет получить количество и массив доступных окон как для конкретного pid, так и для всех существующих окон.

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

0

Список успешно получен.

-1

В случае ошибки, код ошибки записывается в errno.

Коды ошибок:

EINVAL

Некорректный аргумент.

EPERM

Недостаточно привилегий для выполнения функции.

EFAULT

Запрос завершился с ошибкой на стороне сервера.

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

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

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

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

Нет

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

Нет

В потоке

Да

Предыдущий раздел: Окна