SysFn21/ru

Функция 21 - установка системных параметров

---

Подфункция 1 - установить базовый порт MPU MIDI.

Параметры:

• eax = 21 - номер функции
• ebx = 1 - номер подфункции
• ecx = номер базового порта

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

• eax = 0 - успешно
• eax = -1 - ошибочный номер порта

Замечания:

• Номер порта должен удовлетворять условиям 0x100<=ecx<=0xFFFF.
• Установка базы нужна для работы функции 20.
• Получить установленный базовый порт можно вызовом подфункции 1 функции 26.

Подфункция 2 - установить раскладку клавиатуры.

Раскладка клавиатуры используется для преобразования сканкодов, поступающих от клавиатуры, в ASCII-коды, считываемые функцией 2. Параметры:

• eax = 21 - номер функции
• ebx = 2 - номер подфункции
• ecx = какую раскладку устанавливать:
  • 1 = нормальную
  • 2 = раскладку при нажатом Shift
  • 3 = раскладку при нажатом Alt
• edx = указатель на раскладку - таблицу длиной 128 байт

Или:

• ecx = 9
• dx = идентификатор страны (1=eng, 2=fi, 3=ger, 4=rus)

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

• eax = 0 - успешно
• eax = 1 - параметр задан неверно

Замечания:

• Если нажат Alt, то используется раскладка с Alt;
• если не нажат Alt, но нажат Shift, то используется раскладка с Shift;
• если не нажаты Alt и Shift, но нажат Ctrl, то используется нормальная раскладка, после чего из кода вычитается 0x60;
• если не нажата ни одна из управляющих клавиш, то используется нормальная раскладка.
• Получить раскладки и идентификатор страны можно с помощью подфункции 2 функции 26.
• Идентификатор страны - глобальная системная переменная, которая самим ядром не используется; однако приложение @panel отображает соответствующую текущей стране иконку.
• Приложение @panel переключает раскладки по запросу пользователя.

Подфункция 3 - установить базу CD.

Параметры:

• eax = 21 - номер функции
• ebx = 3 - номер подфункции
• ecx = база CD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3

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

• eax = 0

Замечания:

• База CD используется функцией 24.
• Получить установленную базу CD можно вызовом подфункции 3 функции 26.

Подфункция 4 - установить базовый порт Sound Blaster.

Удалена

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

Параметры:

• eax = 21 - номер функции
• ebx = 5 - номер подфункции
• ecx = язык системы (1=eng, 2=fi, 3=ger, 4=rus)

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

• eax = 0

Замечания:

• Язык системы - глобальная системная переменная, никак не используемая самим ядром, однако приложение @panel рисует соответствующую иконку.
• Проверок на корректность не делается, поскольку ядро эту переменную не использует.
• Получить язык системы можно вызовом подфункции 5 функции 26.

Подфункция 7 - установить базу HD.

Внимание: Эта подфункция будет удалена в следующих версиях системы

База HD нужна для определения, на какой жёсткий диск писать, при спользовании устаревшего синтаксиса /HD в устаревшей функции 58; при использовании современного синтаксиса /HD0,/HD1,/HD2,/HD3 база устанавливается автоматически.

Параметры:

• eax = 21 - номер функции
• ebx = 7 - номер подфункции
• ecx = база HD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3

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

• eax = 0

Замечания:

• Любое приложение в любой момент времени может изменить базу.
• Не следует изменять базу, когда какое-нибудь приложение работает с жёстким диском. Если не хотите глюков системы.
• Получить установленную базу можно вызовом подфункции 7 функции 26.
• Следует также определить используемый раздел жёсткого диска подфункцией 8.

Подфункция 8 - установить раздел HD.

Раздел HD нужен для определения, на какой раздел жёсткого диска писать, при использовании устаревшего синтаксиса /HD в устаревшей функции 58; при использовании современного синтаксиса /HD0,/HD1,/HD2,/HD3 база и раздел устанавливаются автоматически.

Параметры:

• eax = 21 - номер функции
• ebx = 8 - номер подфункции
• ecx = раздел HD (считая с 1)

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

• eax = 0

Замечания:

• Любое приложение в любой момент времени может изменить раздел.
• Не следует изменять раздел, когда какое-нибудь приложение работает с жёстким диском. Если не хотите глюков системы.
• Получить установленный раздел можно вызовом подфункции 8 функции 26.
• Проверок на корректность не делается.
• Узнать число разделов на жёстком диске можно вызовом подфункции 11 функции 18.
• Следует также определить используемую базу жёсткого диска подфункцией 7.

Подфункция 10 - установить канал DMA для звука.

Удалена:

Подфункция 11 - разрешить/запретить низкоуровневый доступ к HD.

Параметры:

• eax = 21 - номер функции
• ebx = 11 - номер подфункции
• ecx = 0/1 - запретить/разрешить

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

• eax = 0

Замечания:

• Используется при LBA-чтении (подфункция 8 функции 58).
• Текущая реализация использует только младший бит ecx.
• Получить текущее состояние можно вызовом подфункции 11 функции 26.

Подфункция 12 - разрешить/запретить низкоуровневый доступ к PCI.

Параметры:

• eax = 21 - номер функции
• ebx = 12 - номер подфункции
• ecx = 0/1 - запретить/разрешить

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

• eax = 0

Замечания:

• Используется при работе с шиной PCI (функция 62).
• Текущая реализация использует только младший бит ecx.
• Получить текущее состояние можно вызовом подфункции 12 функции 26.

Подфункция 13

Подподфункция 1 - инициализировать + получить информацию о драйвере vmode.mdr.

Параметры:

• eax = 21 - номер функции
• ebx = 13 - номер подфункции
• ecx = 1 - номер функции драйвера
• edx = указатель на буфер размера 512 байт

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

• если драйвер не загружен (никогда не бывает в текущей реализации):
  • eax = -1
  • ebx, ecx разрушаются
• если драйвер загружен:
  • eax = 'MDAZ' (в стиле fasm'а, т.е. 'M' - младший байт, 'Z' - старший) - сигнатура
  • ebx = текущая частота развёртки (в Гц)
  • ecx разрушается
  • буфер, на который указывает edx, заполнен

Формат буфера:

• +0: 32*byte: имя драйвера, "Trans VideoDriver" (без кавычек, дополнено пробелами)
• +32 = +0x20: dword: версия драйвера (версия x.y кодируется как y*65536+x), для текущей реализации 1 (1.0)
• +36 = +0x24: 7*dword: зарезервировано (0 в текущей реализации)
• +64 = +0x40: 32*word: список поддерживаемых видеорежимов (каждое слово - номер видеорежима, после собственно списка идут нули)
• +128 = +0x80: 32*(5*word): список поддерживаемых частот развёрток для видеорежимов: для каждого видеорежима, указанного в предыдущем поле, указано до 5 поддерживаемых частот (в неиспользуемых позициях записаны нули)

Замечания:

• Функция инициализирует драйвер (если он ещё не инициализирован) и должна вызываться первой, перед остальными (иначе они будут возвращать -1, ничего не делая).
• В текущей реализации поддерживается только одна частота развёртки на видеорежим.

Подподфункция 2 - получить информацию о текущем видеорежиме.

Параметры:

• eax = 21 - номер функции
• ebx = 13 - номер подфункции
• ecx = 2 - номер функции драйвера

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

• eax = -1 - драйвер не загружен или не инициализирован;
  • ebx,ecx разрушаются
• eax = [ширина]*65536 + [высота]
• ebx = частота вертикальной развёртки (в Гц)
• ecx = номер текущего видеорежима

Замечания:

• Драйвер предварительно должен быть инициализирован вызовом функции драйвера 1.
• Если нужны только размеры экрана, целесообразней использовать функцию 14 с учётом того, что она возвращает размеры на 1 меньше.

Подподфункция 3 - установить видеорежим.

Параметры:

• eax = 21 - номер функции
• ebx = 13 - номер подфункции
• ecx = 3 - номер функции драйвера
• edx = [частота развёртки]*65536 + [номер видеорежима]

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

• eax = -1 - драйвер не загружен, не инициализирован или произошла ошибка
• eax = 0 - успешно
• ebx, ecx разрушаются

Замечания:

• Драйвер предварительно должен быть инициализирован вызовом функции драйвера 1.
• Номер видеорежима и частота должны быть в таблице, возвращаемой функцией драйвера 1.

Подподфункция 4 - вернуться к начальному видеорежиму.

Возвращает экран в видеорежим, установленный при загрузке системы.

Параметры:

• eax = 21 - номер функции
• ebx = 13 - номер подфункции
• ecx = 4 - номер функции драйвера

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

• eax = -1 - драйвер не загружен или не инициализирован
• eax = 0 - успешно
• ebx, ecx разрушаются

Замечания:

• Драйвер предварительно должен быть инициализирован вызовом функции драйвера 1.

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

Параметры:

• eax = 21 - номер функции
• ebx = 13 - номер подфункции
• ecx = 5 - номер функции драйвера
• edx = 0/1 - уменьшить/увеличить размер по горизонтали на одну позицию
• edx = 2/3 - в текущей реализации не поддерживается; планируется как уменьшение/увеличение размера по вертикали на одну позицию

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

• eax = -1 - драйвер не загружен или не инициализирован
• eax = 0 - успешно
• ebx, ecx разрушаются

Замечания:

• Драйвер предварительно должен быть инициализирован вызовом функции драйвера 1.
• Функция влияет только на физический размер изображения на мониторе; логический размер (число пикселей) не меняется.