Difference between revisions of "SysFn46/ru"

From KolibriOS wiki
Jump to navigation Jump to search
m
Line 2: Line 2:
  
 
----
 
----
 
К зарезервированным портам можно обращаться напрямую из приложения командами in/out (рекомендуемый способ) и вызовом функции 43 (нерекомендуемый способ).
 
 
 
'''Внимание:'''
 
'''Внимание:'''
 
* Эта функция устарела и может быть удалена в следующих версиях ядра.  
 
* Эта функция устарела и может быть удалена в следующих версиях ядра.  
 
* При необходимости прямого (бездрайверного) ввода/вывода в порты и в память внешних устройств рекомендуется использовать [[SysFn62|функцию 62]]
 
* При необходимости прямого (бездрайверного) ввода/вывода в порты и в память внешних устройств рекомендуется использовать [[SysFn62|функцию 62]]
  
'''Параметры:'''
+
К зарезервированным портам можно обращаться напрямую из приложения командами in/out (рекомендуемый способ) и вызовом функции 43 (нерекомендуемый способ).
 +
Параметры:
 
* eax = 46 - номер функции
 
* eax = 46 - номер функции
 
* ebx = 0 - зарезервировать, 1 - освободить
 
* ebx = 0 - зарезервировать, 1 - освободить
 
* ecx = номер начала диапазона портов
 
* ecx = номер начала диапазона портов
 
* edx = номер конца диапазона портов (включительно)
 
* edx = номер конца диапазона портов (включительно)
 
+
Возвращаемое значение:
'''Возвращаемое значение:'''
 
 
* eax = 0 - успешно
 
* eax = 0 - успешно
 
* eax = 1 - ошибка
 
* eax = 1 - ошибка
 
+
Замечания:
'''Замечания:'''
+
* В случае резервирования портов ошибкой считается выполнение одного из условий:
* В случае резервирования портов ошибкой считается невыполнение одного из следующих условий:
+
:* начальный адрес больше конечного;
** начальный адрес должен быть не больше конечного;
+
:* указанный диапазон содержит некорректный номер порта (корректные - от 0 до 0xFFFF);
** указанный диапазон должен содержать корректные адреса портов (в диапазоне от 0 до 0xFFFF);
+
:* превышено ограничение на общее число зарезервированных областей - допускается максимум 255;
** допускается не более 255 резервируемых адресов;
+
:* указанный диапазон пересекается с одним из ранее зарезервированных
** указанный диапазон не должен пересекаться с одним из ранее зарезервированных.
+
* В случае освобождения портов ошибкой считается попытка освобождения диапазона, который ранее не был целиком зарезервирован этой же функцией (с такими же значениями ecx,edx).
* В случае освобождения портов ошибкой считается попытка освобождения диапазона, который ранее не был целиком зарезервирован этой же функцией (с такими же значениями ecx, edx).
 
 
* При обнаружении ошибки (в обоих случаях) никаких действий не производится.
 
* При обнаружении ошибки (в обоих случаях) никаких действий не производится.
 
* При загрузке система резервирует за собой порты 0..0x2d, 0x30..0x4d, 0x50..0xdf, 0xe5..0xff (включительно).
 
* При загрузке система резервирует за собой порты 0..0x2d, 0x30..0x4d, 0x50..0xdf, 0xe5..0xff (включительно).

Revision as of 09:51, 16 December 2013

Функция 46 - зарезервировать/освободить группу портов ввода/вывода


Внимание:

  • Эта функция устарела и может быть удалена в следующих версиях ядра.
  • При необходимости прямого (бездрайверного) ввода/вывода в порты и в память внешних устройств рекомендуется использовать функцию 62

К зарезервированным портам можно обращаться напрямую из приложения командами in/out (рекомендуемый способ) и вызовом функции 43 (нерекомендуемый способ). Параметры:

  • eax = 46 - номер функции
  • ebx = 0 - зарезервировать, 1 - освободить
  • ecx = номер начала диапазона портов
  • edx = номер конца диапазона портов (включительно)

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

  • eax = 0 - успешно
  • eax = 1 - ошибка

Замечания:

  • В случае резервирования портов ошибкой считается выполнение одного из условий:
  • начальный адрес больше конечного;
  • указанный диапазон содержит некорректный номер порта (корректные - от 0 до 0xFFFF);
  • превышено ограничение на общее число зарезервированных областей - допускается максимум 255;
  • указанный диапазон пересекается с одним из ранее зарезервированных
  • В случае освобождения портов ошибкой считается попытка освобождения диапазона, который ранее не был целиком зарезервирован этой же функцией (с такими же значениями ecx,edx).
  • При обнаружении ошибки (в обоих случаях) никаких действий не производится.
  • При загрузке система резервирует за собой порты 0..0x2d, 0x30..0x4d, 0x50..0xdf, 0xe5..0xff (включительно).
  • При завершении потока автоматически освобождаются все зарезервированные им порты.