SysFn68/ru

Функция 68 - внутренние системные службы

Подфункция 0 - получить счётчик переключений задач.

Параметры:

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

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

• eax = число переключений задач с момента загрузки системы (по модулю 2^32)

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

eax - SF_SYS_MISC (68)

ebx - SSF_GET_TASK_SWITCH_COUNT (0)

Подфункция 1 - переключиться на следующий поток выполнения.

Функция завершает текущий квант времени, выделенный потоку, и переключается на следующий. (Какой поток какого процесса будет следующим, предсказать нельзя). Позднее, когда до текущего потока дойдёт очередь, выполнение возобновится.

Параметры:

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

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

• функция не возвращает значения

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

eax - SF_SYS_MISC (68)

ebx - SSF_SWITCH_TASK (1)

Подфункция 2 - кэш + rdpmc.

Параметры:

• eax = 68 - номер функции
• ebx = 2 - номер подфункции
• ecx = требуемое действие:
• ecx = 0 - разрешить выполнение инструкции rdpmc (ReaD Performance-Monitoring Counters)
• ecx = 1 - узнать, включён/выключен кэш
• ecx = 2 - включить кэш
• ecx = 3 - выключить кэш

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

• для ecx=0:
  • eax = значение cr4
• для ecx=1:
  • eax = (cr0 and 0x60000000):
• eax = 0 - кэш включён
• eax <> 0 - кэш выключен
• для ecx=2 и ecx=3 функция не возвращает значения

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

eax - SF_SYS_MISC (68)

ebx - SSF_PERFORMANCE (2)

ecx - SSSF_ALLOW_RDPMC (0), SSSF_CACHE_STATUS (1),

SSSF_CACHE_ON (2), SSSF_CACHE_OFF (3)

Подфункция 3 - прочитать MSR-регистр.

MSR = Model Specific Register; полный список MSR-регистров процессора содержится в документации по процессору (например, IA-32 Intel Architecture Software Developer's Manual, Volume 3, Appendix B); каждое семейство процессоров имеет своё подмножество MSR-регистров.

Параметры:

• eax = 68 - номер функции
• ebx = 3 - номер подфункции
• ecx игнорируется
• edx = адрес MSR

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

• ebx:eax = старший:младший dword результата

Замечания:

• Указание в ecx несуществующего или нереализованного для данного процессора MSR повлечёт исключение в ядре, которое прибьёт поток.
• Предварительно следует определить, поддерживаются ли MSR в целом, командой cpuid. Иначе возникнет уже другое исключение в ядре, которое всё равно прибьёт поток.

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

eax - SF_SYS_MISC (68)

ebx - SSF_READ_MSR (3)

Подфункция 4 - записать в MSR-регистр.

MSR = Model Specific Register; полный список MSR-регистров процессора содержится в документации по процессору (например, IA-32 Intel Architecture Software Developer's Manual, Volume 3, Appendix B); каждое семейство процессоров имеет своё подмножество MSR-регистров.

Параметры:

• eax = 68 - номер функции
• ebx = 4 - номер подфункции
• ecx игнорируется
• edx = адрес MSR
• esi:edi = старший:младший dword

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

• функция не возвращает значения

Замечания:

• Указание в ecx несуществующего или нереализованного для данного процессора MSR повлечёт исключение в ядре, которое прибьёт поток.
• Предварительно следует определить, поддерживаются ли MSR в целом, командой cpuid. Иначе возникнет уже другое исключение в ядре, которое всё равно прибьёт поток.

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

eax - SF_SYS_MISC (68)

ebx - SSF_WRITE_MSR (4)

Подфункция 11 - вручную инициализировать кучу процесса.

Параметры:

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

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

• eax = 0 - неуспех
• иначе размер созданной кучи

Замечания:

• Вызов функции инициализирует кучу, из которой впоследствии можно выделять и освобождать блоки памяти подфункциями 12, 13 и 20.
• Если куча уже создана, функция вернёт размер существующей кучи. Размер кучи равен размеру всей свободной памяти приложения.
• После создания кучи вызовы функции 64 игнорируются.

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

eax - SF_SYS_MISC (68)

ebx - SSF_HEAP_INIT (11)

Подфункция 12 - выделить блок памяти.

Параметры:

• eax = 68 - номер функции
• ebx = 12 - номер подфункции
• ecx = требуемый размер в байтах

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

• eax = указатель на выделенный блок

Замечания:

• Функция выделяет целое число страниц (4 Кб) так, что фактический размер выделенного блока больше или равен запрошенному.

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

eax - SF_SYS_MISC (68)

ebx - SSF_MEM_ALLOC (12)

Подфункция 13 - освободить блок памяти.

Параметры:

• eax = 68 - номер функции
• ebx = 13 - номер подфункции
• ecx = указатель на блок памяти

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

• eax = 1 - успешно
• eax = 0 - неудача

Замечания:

• Блок памяти должен быть ранее выделен подфункцией 12 или подфункцией 20.

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

eax - SF_SYS_MISC (68)

ebx - SSF_MEM_FREE (13)

Подфункция 14 - ожидать извещения от драйвера.

Параметры:

• eax = 68 - номер функции
• ebx = 14 - номер подфункции
• ecx = указатель на буфер для информации (8 байт)

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

• буфер, на который указывает ecx, содержит следующую информацию:
• +0: dword: константа EV_INTR = 1
• +4: dword: данные драйвера

Замечания:

• Текущая реализация во время ожидания требует довольно "тяжёлых" операций переключения контекста.

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

eax - SF_SYS_MISC (68)

ebx - SSF_WAIT_SIGNAL (14)

Подфункция 16 - загрузить драйвер.

Параметры:

• eax = 68 - номер функции
• ebx = 16 - номер подфункции
• ecx = указатель на ASCIIZ-строку с именем драйвера

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

• eax = 0 - неудача
• иначе eax = хэндл драйвера

Замечания:

• Если драйвер ещё не загружен, он загружается; если драйвер уже загружен, ничего не меняется.
• Имя драйвера чувствительно к регистру символов. Максимальная длина имени - 16 символов, включая завершающий нулевой символ, остальные символы игнорируются.
• Драйвер с именем ABC загружается из файла /rd/1/drivers/ABC.sys.

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

eax - SF_SYS_MISC (68)

ebx - SSF_LOAD_DRIVER (16)

Подфункция 17 - управление драйвером.

Параметры:

• eax = 68 - номер функции
• ebx = 17 - номер подфункции
• ecx = указатель на управляющую структуру:
  • +0: dword: хэндл драйвера
  • +4: dword: код функции драйвера
  • +8: dword: указатель на входные данные
  • +12 = +0xC: dword: размер входных данных
  • +16 = +0x10: dword: указатель на выходные данные
  • +20 = +0x14: dword: размер выходных данных

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

• eax = определяется драйвером

Замечания:

• Коды функций и структура входных/выходных данных определяются драйвером.
• Предварительно должен быть получен хэндл драйвера подфункцией 16.

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

eax - SF_SYS_MISC (68)

ebx - SSF_CONTROL_DRIVER (17)

Подфункция 18 - загрузить DLL с указанием кодировки.

Параметры:

• eax = 68 - номер функции
• ebx = 18 - номер подфункции
• ecx = указатель на строку с путём к DLL
• edx = кодировка строки, подробности указаны в описании функции 80.

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

• eax = 0 - неудача
• иначе eax = указатель на таблицу экспорта DLL

Замечания:

• Таблица экспорта представляет собой массив структур по 2 dword'а, заканчивающийся нулём. Первый dword в структуре является указателем на имя функции, второй содержит адрес функции.

Подфункция 19 - загрузить DLL.

Параметры:

• eax = 68 - номер функции
• ebx = 19 - номер подфункции
• ecx = указатель на строку с путём к DLL, правила формирования строки указаны в описании функции 70.

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

• eax = 0 - неудача
• иначе eax = указатель на таблицу экспорта DLL

Замечания:

• Таблица экспорта представляет собой массив структур по 2 dword'а, заканчивающийся нулём. Первый dword в структуре является указателем на имя функции, второй содержит адрес функции.

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

eax - SF_SYS_MISC (68)

ebx - SSF_LOAD_DLL (19)

Подфункция 20 - перераспределить блок памяти.

Параметры:

• eax = 68 - номер функции
• ebx = 20 - номер подфункции
• ecx = новый размер в байтах
• edx = указатель на уже выделенный блок памяти

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

• eax = указатель на перераспределённый блок, 0 при ошибке

Замечания:

• Предварительно следует инициализировать кучу процесса вызовом подфункции 11.
• Функция выделяет целое число страниц (4 Кб) так, что фактический размер выделенного блока больше или равен запрошенному.
• Если edx=0, то вызов функции эквивалентен выделению памяти подфункцией 12. В противном случае блок памяти по адресу edx должен быть ранее выделен подфункцией 12 или описываемой подфункцией.
• Если ecx=0, то функция освобождает блок памяти по адресу edx и возвращает 0.
• Содержимое памяти вплоть до наименьшего из старого и нового размеров сохраняется.

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

eax - SF_SYS_MISC (68)

ebx - SSF_MEM_REALLOC (20)

Подфункция 21 - загрузка PE драйвера

Параметры:

• eax = 68 - номер функции
• ebx = 21 - номер подфункции
• ecx = указатель на ASCIIZ-строку с именем драйвера
• edx = указатель на командную строку

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

• eax = 0 - неудача
• иначе eax = хэндл драйвера

Замечания:

• Если драйвер ещё не загружен, он загружается; если драйвер уже загружен, ничего не меняется.

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

eax - SF_SYS_MISC (68)

ebx - SSF_LOAD_DRIVER_PE (21)

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

Параметры:

• eax = 68 - номер функции
• ebx = 22 - номер подфункции
• ecx = указатель на имя области. Максимум 32 символа включая завершающий ноль
• edx = размер области в байтах для SHM_CREATE и SHM_OPEN_ALWAYS
• esi = флаги открытия и доступа

SHM_OPEN = 0x00

SHM_OPEN_ALWAYS = 0x04

SHM_CREATE = 0x08

SHM_READ = 0x00

SHM_WRITE = 0x01

• SHM_CREATE - создать новую область памяти. Если область с таким именем уже существует функция вернёт код ошибки E_ACCESS
• SHM_OPEN_ALWAYS - открывает существующую или создаёт новую область памяти.
• SHM_OPEN - открывает существующую область памяти. Если область с таким именем не существует функция вернёт код ошибки E_NOTFOUND.
• SHM_READ - доступ только на чтение.
• SHM_WRITE - доступ на чтение и запись.

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

• eax = указатель на область памяти или ноль в случае ошибки
• edx = если новая область создаётся SHM_CREATE или SHM_OPEN_ALWAYS ноль в случае успеха или код ошибки. Если существующая область открывается SHM_OPEN или SHM_OPEN_ALWAYS размер области в байтах или код ошибки.

Коды ошибок:

• E_NOTFOUND = 5
• E_ACCESS = 10
• E_NOMEM = 30
• E_PARAM = 33

Замечания:

• Предварительно следует инициализировать кучу процесса вызовом подфункции 11.
• Если создаётся новая область то флаги доступа устанавливают максимальные права доступа для остальных процессов.
• Родительский процесс всегда имеет доступ на запись.

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

eax - SF_SYS_MISC (68)

ebx - SSF_MEM_OPEN (22)

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

Параметры:

• eax = 68 - номер функции
• ebx = 23 - номер подфункции
• ecx = указатель на имя области. Максимум 31 символ включая завершающий ноль

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

• разрушается

Замечания:

• Область памяти физически освобождается (с забыванием всех данных и высвобождением физической памяти), когда её закроют все открывшие потоки.
• При завершении потока освобождаются все открытые им области памяти.

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

eax - SF_SYS_MISC (68)

ebx - SSF_MEM_CLOSE (23)

Подфункция 24 - установить обработчик исключений

Параметры:

• eax = 68 - номер функции
• ebx = 24 - номер подфункции
• ecx = адрес нового обработчика исключений
• edx = маска обрабатываемых исключений

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

• eax = адрес старого обработчика исключений (0, если не установлен)
• ebx = маска старого обработчика исключений

Замечания:

• Номер бита в маске исключений соответствует номеру исключения по спецификации на процессор (Intel-PC). Так, например, исключения FPU имеют номер 16 (#MF), а SSE - 19 (#XF).
• В данной реализации игнорируется запрос на перехват исключения 7 - система обрабатывает #NM самостоятельно.
• Пользовательский обработчик получает номер исключения параметром в стеке. Поэтому правильный выход из обработчика: RET 4. Возврат при этом производится на команду, вызвавшую исключение.
• При передаче управления обработчику исключений сбрасывается соответствующий бит в маске исключений. Возникновение этого же исключения впоследствии приведёт к умолчальной обработке такового. А именно: к завершению работы приложения в отсутствии отладчика, приостановка с уведомлением отлаживающего приложения иначе.
• После завершения критических действий в обработчике пользователя восстановление бита маски данного исключения можно сделать подфункцией 25. Сброс флагов исключений в модулях FPU и XMM также возлагается на обработчик пользователя.

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

eax - SF_SYS_MISC (68)

ebx - SSF_SET_EXCEPTION_HANDLER (24)

Подфункция 25 - изменить состояние активности сигнала

Параметры:

• eax = 68 - номер функции
• ebx = 25 - номер подфункции
• ecx = номер сигнала
• edx = значение устанавливаемой активности (0/1)

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

• eax = -1 - задан неверный номер сигнала
• иначе eax = старое значение активности сигнала (0/1)

Замечания:

• В текущей реализации изменяется только маска пользовательского обработчика исключений, установленного подфункцией 24. При этом номер сигнала соответствует номеру исключения.

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

eax - SF_SYS_MISC (68)

ebx - SSF_SET_EXCEPTION_STATE (25)

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

Параметры:

• eax = 68 - номер функции
• ebx = 26 - номер подфункции
• ecx = указатель на блок памяти выделенный подфункцией 12
• edx = смещение от начала блока
• esi = размер высвобождаемого блока памяти, в байтах

Примечания:

• функция освобождает страницы с ecx+edx по ecx+edx+esi и устанавливает виртуальную память в зарезервированное состояние.

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

eax - SF_SYS_MISC (68)

ebx - SSF_MEM_FREE_EXT (26)

Подфункция 27 - загрузить файл

Параметры:

• eax = 68 - номер функции
• ebx = 27 - номер подфункции
• ecx = указатель на строку с путём к файлу, правила формирования строки указаны в описании функции 70.

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

• eax = адрес области памяти, содержащей загруженный файл
• edx = размер файла

Замечания:

• функция загружает и, при необходимости, распаковывает файл (kpack)

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

eax - SF_SYS_MISC (68)

ebx - SSF_LOAD_FILE (27)

Подфункция 28 - загрузить файл с указанием кодировки

Параметры:

• eax = 68 - номер функции
• ebx = 28 - номер подфункции
• ecx = указатель на строку с путём к файлу
• edx = кодировка строки, подробности указаны в описании функции 80.

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

• eax = указатель на загруженный файл или 0
• edx = размер загруженного файла или 0

Примечания:

• функция загружает и, при необходимости, распаковывает файл (kpack)