Описание программы. 
Windows API

В соответствии с вариантом было написано консольное приложение «Художественный холст» в текстовом режиме. Программа по нажатию левой кнопки мыши выводит в позицию курсора символ пера, по нажатию правой кнопки мыши стирает символ по позиции курсора. Символ пера можно изменять с клавиатуры, в левом верхнем углу, присутствует индикатор, показывающий текущий символ пера. В нижнем левом углу отображаются текущие координаты курсора в окне.

Рисунок 1 — Пример работы программы.

Используемые функции

wsprintfA.

Эта функция является неким аналогом библиотечной Си-функции — sprintf. Первым параметром функции является указатель на буфер, куда помещается результат форматирования. Второй — указатель на форматную строку, например: «Числа: %lu, %lu». Далее идут указатели на параметры (либо сами параметры, если это числа), число которых определено только содержимым форматной строки. Поскольку количество параметров не определено, то стек освобождает программист. Пример использования этой функции будет дан ниже. Прототипом этой функции для библиотеки import32. lib (TASM32) будет не wsprintfA, a _wsprintfA (!). Если функция выполнена успешно, то в EAX будет возвращена длина скопированной строки.

ADD ESP, N.

Данная команда освобождает N байт стека.

ReadConsoleInput.

Эта функция предназначена для получения информации о клавиатуре и мыши в консольном режиме.

Параметры этой функции:

• 1. дескриптор входного буфера консоли.
• 2. указатель на структуру (или массив структур), в которой содержится информация о событиях, происшедших с консолью.
• 3. количество получаемых информационных записей (структур).
• 4. указатель на двойное слово, содержащее количество реально полученных записей.

GetStdHandle.

Эта функция используется для получения дескриптора консоли. Её аргументом может одна из следующих констант:

STD_INPUT_HANDLE equ -10; для ввода.

STD_OUTPUT_HANDLE equ -11; для вывода.

STD_ERROR_HANDLE equ -12; для сообщения об ошибке.

WriteConsoleA.

Для вывода текстовой информации используется функция API WriteConsoleA, параметры которой (слева направо) имеют следующий смысл.

• · 1-й параметр — дескриптор буфера вывода консоли, который может быть получен при помощи функции GetStdHandle.
• · 2-й параметр — указатель на буфер, где находится выводимый текст.
• · 3-й параметр — количество выводимых символов.
• · 4-й параметр — указывает на переменную DWORD, куда будет помещено количество действительно выведенных символов.
• · 5-й параметр — резервный параметр, должен быть равен нулю.

Буфер, где находится выводимый текст, не обязательно должен заканчиваться нулем, поскольку для данной функции указывается количество выводимых символов.

SetConsoleCursorPosition.

Установить позицию курсора в консоли можно при помощи функции SetConsoleCursorPosition со следующими параметрами:

• · 1-й, дескриптор входного буфера консоли.
• · 2-й, структура COORD:

COORD STRUC.

Х WORD ?

Y WORD ?

COORD ENDS.

SetConsoleTitle

Для определения заголовка окна консоли используется функция SetConsoleTitle, единственным параметром которой является адрес строки с нулем на конце.

FreeConsole.

Данная функция принудительно освобождает консоль.

Следует отметить, что один процесс может иметь только одну консоль, поэтому выполнение в начале программы FreeConsole обязательно. При запуске программы в «чужой» консоли она наследует эту консоль, поэтому, пока мы не выполним функцию FreeConsole, новой консоли не создать — чужой консоли эта функция закрыть не может.

AllocConsole.

Для создания консоли приложение вызывает API-функцию WindowsAllocConsole:

Function AllocConsole Lib «kernel32» Alias DWORD «AllocConsole» ().

Из описания этой функции видно, что она содержится в библиотеке Windowskernel32, поэтому в секцию директив нашей ассемблерной программы мы должны включить соответствующие файлы прототипов (kernel32.inc) и библиотек (kernel32.lib). По выполнении функцияAllocConsoleзаписывает (возвращает) в регистрEAXзначение длиной 4 байта (DWORD). Если консоль создать не удалось, в регистрEAXбудет записан ноль.

CharToOemA.

Windows (русскоязычная) использует кодировку Win1251, консоль — DOS. Поскольку ассемблерную программу мы набираем все же под Windows, определяемые в ней символьные строки на кириллице в память компьютера попадут в кодировке Win1251 и в консоли будут выглядеть нечитаемо. API-функция WindowsCharToOemпредназначена для перевода кодировки строки Win1251 в DOS, ее удобно использовать при организации вывода в консоль кириллических символов.

В отличие от кириллицы, числовые значения, сопоставляемые цифрам и латинским символам, одинаковы в обеих кодировках, поэтому, если в консоль выводится только латиница и числа, функциюCharToOemиспользовать не нужно.

Функция определяется следующим образом: Function CharToOem Lib «user32» Alias DWORD «CharToOemA» (DWORD lpszSrc, DWORD lpszDst).

Функция содержится в библиотеке Windowsuser32, в секцию директив ассемблерной программы перед ее вызовом помещаем указания на соответствующие файлы прототипов (user32.inc) и библиотек (user32.lib). По выполнении функция возвращает в регистрEAXзначение длиной 4 байта: старшие 3 байта равны нулю, младший байт равен 1, если адреса источника и приемника не совпадают, при их совпадении — 0.

Передаваемые функции параметры: lpszSrc- (long pointer string zero Source) адрес заканчивающейся нулем строки-источника;lpszDst- (long pointer string zero Destination) адрес строки-приемника.

Есть особенность в обработке строк ассемблером, эту особенность надо учитывать при использовании функцииCharToOem. Ассемблер никак не отграничивает в исполняемом коде строки символов друг от друга или от числовых переменных. В конце строки ассемблер не пишет условного байта, указывающего на ее завершение. Возможность обращаться в ассемблерной программе к каждой символьной переменной в отдельности (по ее имени) связана с тем, что MASM32 вычисляет по объявлению размер каждой символьной переменной, при компиляции подставляет, если на то есть необходимость, в исполняемый код соответствующие значения длины строки.

ФункцияCharToOemтребует, чтобы строка-источник оканчивалась нулем (string zero, по-другомуnull-terminated). Если мы этой функции передадим в качестве источника адрес из нашего сегмента данных, она поведет себя соответственно — будет перекодировать, начиная с переданного ей адреса, в сегменте данных все, в том числе и числовые переменные любой размерности, вплоть до первого встретившегося ей нуля. Microsoft MSDN называет функциюCharToOemопасной — небрежно включенная в код, она наверняка вызовет аварийное завершение программы.

В то же время строке-приемнику заканчиваться нулем не обязательно — достаточно лишь того, чтобы строка-источник вмещалась в приемник, то есть приемник должен иметь размер не менее, чем строка-источник.

SetConsoleTextAttribute.

Установить цвет выводимых букв можно с помощью функции SetConsoleTextAttribute. Первым параметром этой функции является дескриптор выходного буфера консоли, а вторым — цвет букв и фона. Цвет получается путем комбинации (сумма или операция «ИЛИ») двух или более из представленных ниже констант. Причем возможна «смесь» не только цвета и интенсивности, но и цветов (см. программа ниже).

FOREGROUND_BLUE equ 1h; синий цвет букв.

FOREGROUND_GREEN equ 2h; зеленый цвет букв.

FOREGROUND_RED equ 4h; красный цвет букв.

FOREGROUND_INTENSITY equ 8h; повышенная интенсивность.

BACKGROUND_BLUE equ 10h; синий свет фона.

BACKGROUND_GREEN equ 20h; зеленый цвет фона.

BACKGROUND_RED equ 40h; красный цвет фона.

BACKGROUND_INTENSITY equ 80h; повышенная интенсивность.

SetConsoleScreenBufferSize.

Функция SetConsoleScreenBufferSize устанавливает размер буфера окна консоли. Этот размер не может уменьшить уже существующий буфер (существующее окно), а может только его увеличить.

• · 1-й, дескриптор входного буфера консоли.
• · 2-й, структура COORD:

COORD STRUC.

Х WORD ?

Y WORD ?

COORD ENDS.