SysFn54/ru: Difference between revisions

From KolibriOS wiki
Jump to navigation Jump to search
mNo edit summary
Line 1: Line 1:
'''Функция 54 - работа с буфером обмена'''
'''Функция 54''' - работа с буфером обмена
=== Подфункция 0 - узнать количество слотов в буфере обмена. ===
=== Подфункция 0 - узнать количество слотов в буфере обмена. ===
Параметры:
Параметры:
* eax = 54 - номер функции
:* eax = 54 - номер функции
* ebx = 0 - номер подфункции
:* ebx = 0 - номер подфункции
Возвращаемое значение:
Возвращаемое значение:
* eax = количество слотов в буфере  
:* eax = количество слотов в буфере  
* eax = -1 - отсутствует область главного списка
:* eax = -1 - отсутствует область главного списка
 
'''Константы для регистров:'''
::eax - SF_CLIPBOARD (54)
::ebx - SSF_GET_SLOT_COUNT (0)


=== Подфункция 1 - считать данные из буфера обмена. ===
=== Подфункция 1 - считать данные из буфера обмена. ===
Параметры:
Параметры:
* eax = 54 - номер функции
:* eax = 54 - номер функции
* ebx = 1 - номер подфункции
:* ebx = 1 - номер подфункции
* eсx = номер слота
:* eсx = номер слота
Возвращаемое значение:
Возвращаемое значение:
* eax = если успешно - указатель на область памяти с данными
:* eax = если успешно - указатель на область памяти с данными
* eax = 1 - ошибка
:* eax = 1 - ошибка
* eax = -1 - отсутствует область главного списка
:* eax = -1 - отсутствует область главного списка
 
'''Константы для регистров:'''
::eax - SF_CLIPBOARD (54)
::ebx - SSF_READ_CB (1)
 
=== Подфункция 2 - записать данные в буфер обмена. ===
=== Подфункция 2 - записать данные в буфер обмена. ===
Параметры:
Параметры:
* eax = 54 - номер функции
:* eax = 54 - номер функции
* ebx = 2 - номер подфункции
:* ebx = 2 - номер подфункции
* eсx = количество копируемых байт
:* eсx = количество копируемых байт
* edx = указатель на буфер под копируемые данные
:* edx = указатель на буфер под копируемые данные
Возвращаемое значение:
Возвращаемое значение:
* eax = 0 - успешно
:* eax = 0 - успешно
* eax = 1 - ошибка
:* eax = 1 - ошибка
* eax = -1 - отсутствует область главного списка
:* eax = -1 - отсутствует область главного списка
 
'''Константы для регистров:'''
::eax - SF_CLIPBOARD (54)
::ebx - SSF_WRITE_CB (2)


=== Подфункция 3 - удалить последний слот с данными в буфере обмена ===
=== Подфункция 3 - удалить последний слот с данными в буфере обмена ===
Параметры:
Параметры:
* eax = 54 - номер функции
:* eax = 54 - номер функции
* ebx = 3 - номер подфункции
:* ebx = 3 - номер подфункции
Возвращаемое значение:
Возвращаемое значение:
* eax = 0 - успешно
:* eax = 0 - успешно
* eax = 1 - ошибка
:* eax = 1 - ошибка
* eax = -1 - отсутствует область главного списка
:* eax = -1 - отсутствует область главного списка
 
'''Константы для регистров:'''
::eax - SF_CLIPBOARD (54)
::ebx - SSF_DEL_SLOT (3)


=== Подфункция 4 - аварийный сброс блокировки буфера ===
=== Подфункция 4 - аварийный сброс блокировки буфера ===
Параметры:
Параметры:
* eax = 54 - номер функции
:* eax = 54 - номер функции
* ebx = 4 - номер подфункции
:* ebx = 4 - номер подфункции
Возвращаемое значение:
Возвращаемое значение:
* eax = 0 - успешно
:* eax = 0 - успешно
* eax = -1 - отсутствует область главного списка или нет блокировки
:* eax = -1 - отсутствует область главного списка или нет блокировки
Замечания:
Замечания:
* Используется в исключительных случаях, когда зависшее или убитое приложение заблокировало работу с буфером обмена.
:* Используется в исключительных случаях, когда зависшее или убитое приложение заблокировало работу с буфером обмена.


'''Константы для регистров:'''
::eax - SF_CLIPBOARD (54)
::ebx - SSF_UNLOCK_BUFFER (4)


=== Содержимое контейнера буфера обмена ===
=== Содержимое контейнера буфера обмена ===

Revision as of 19:03, 17 January 2016

Функция 54 - работа с буфером обмена

Подфункция 0 - узнать количество слотов в буфере обмена.

Параметры:

  • eax = 54 - номер функции
  • ebx = 0 - номер подфункции

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

  • eax = количество слотов в буфере
  • eax = -1 - отсутствует область главного списка

Константы для регистров:

eax - SF_CLIPBOARD (54)
ebx - SSF_GET_SLOT_COUNT (0)

Подфункция 1 - считать данные из буфера обмена.

Параметры:

  • eax = 54 - номер функции
  • ebx = 1 - номер подфункции
  • eсx = номер слота

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

  • eax = если успешно - указатель на область памяти с данными
  • eax = 1 - ошибка
  • eax = -1 - отсутствует область главного списка

Константы для регистров:

eax - SF_CLIPBOARD (54)
ebx - SSF_READ_CB (1)

Подфункция 2 - записать данные в буфер обмена.

Параметры:

  • eax = 54 - номер функции
  • ebx = 2 - номер подфункции
  • eсx = количество копируемых байт
  • edx = указатель на буфер под копируемые данные

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

  • eax = 0 - успешно
  • eax = 1 - ошибка
  • eax = -1 - отсутствует область главного списка

Константы для регистров:

eax - SF_CLIPBOARD (54)
ebx - SSF_WRITE_CB (2)

Подфункция 3 - удалить последний слот с данными в буфере обмена

Параметры:

  • eax = 54 - номер функции
  • ebx = 3 - номер подфункции

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

  • eax = 0 - успешно
  • eax = 1 - ошибка
  • eax = -1 - отсутствует область главного списка

Константы для регистров:

eax - SF_CLIPBOARD (54)
ebx - SSF_DEL_SLOT (3)

Подфункция 4 - аварийный сброс блокировки буфера

Параметры:

  • eax = 54 - номер функции
  • ebx = 4 - номер подфункции

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

  • eax = 0 - успешно
  • eax = -1 - отсутствует область главного списка или нет блокировки

Замечания:

  • Используется в исключительных случаях, когда зависшее или убитое приложение заблокировало работу с буфером обмена.

Константы для регистров:

eax - SF_CLIPBOARD (54)
ebx - SSF_UNLOCK_BUFFER (4)

Содержимое контейнера буфера обмена

1. Первый dword содержит общую длину данных в контейнере

2. Второй dword указывает тип данныx:

0 = Текст
1 = Изображение
2 = RAW
4 и выше зарезервировано

2.1 Текст

Данные в третьем dword содержат тип:
0 = UTF
1 = 0866::
2 = 1251
3 и выше зарезервировано

2.2 Изображение

Третий dword - размер по X
Четвертый dword - размер по Y
Пятый dword - глубина цвета в битах (8, 16, 24, 32, 48, 64)
Шестой dword - Указатель на палитру (смещение от начала файла).
Если палитры нет то значение 0
Седьмой dword - Размер области палитры, максимальное значение 256*4=1024байт.
Если палитры нет то значение 0
Восьмой dword - Указатель на данные пикселей для R, G, B.
Девятый dword - Размер области данных для пикселей.

2.3 RAW

Может содержать любые данные, т.к. содержимое на усмотрение программиста