Размещено на http://www.allbest.ru/

Введение

Windows API-- набор функций операционной системы

Аббревиатура API многим начинающим программистам кажется весьма таинственной и даже пугающей. На самом же деле Application Programming Interface (API)-- это просто некоторый готовый набор функций, который могут использовать разработчики приложений. В общем случае данное понятие эквивалентно тому, что раньше чаще называли библиотекой подпрограмм. Однако обычно под API подразумевается особая категория таких библиотек. программа приложение windows

В ходе разработки практически любого достаточно сложного приложения (MyAppication) для конечного пользователя формируется набор специфических внутренних функций, используемых для реализации данной конкретной программы, который называется MyApplication API. Однако часто оказывается, что эти функции могут эффективно использоваться и для создания других приложений, в том числе другими программистами. В этом случае авторы, исходя из стратегии продвижения своего продукта, должны решить вопрос: открывают они доступ к этому набору для внешних пользователей или нет? При утвердительном ответе в описании программного пакета в качестве положительной характеристики появляется фраза: «Комплект включает открытый набор API-функций» (но иногда за дополнительные деньги).

Таким образом, чаще всего под API подразумевается набор функций, являющихся частью одного приложения, но при этом доступных для использования в других программах. Например, Excel, кроме интерфейса для конечного пользователя, имеет набор функций Excel API, который может использоваться, в частности, при создании приложений с помощью VB.

Соответственно Windows API-- это набор функций, являющийся частью самой операционной системы и в то же время-- доступный для любого другого приложения, в том числе написанного с помощью VB. В этом плане вполне оправданна аналогия с набором системных прерываний BIOS/DOS, который фактически представляет собой DOS API.

Отличие заключается в том, что состав функций Windows API, с одной стороны, значительно шире по сравнению с DOS, с другой -- не включает многие средства прямого управления ресурсами компьютера, которые были доступны программистам в предыдущей ОС. Кроме того, обращение к Windows API выполняется с помощью обыкновенных процедурных обращений, а вызов функций DOS-- через специальную машинную команду процессора, которая называется Interrupt («прерывание»).

Задание

Написать консольное приложение, обрабатывающее сигналы от клавиатуры и мыши, с использованием API-функций.

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

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

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

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

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

Заключение

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

Список используемой литературы

1. Изучение операционной системы WINDOWS: метод. указания для выполнения курсовой работы по курсу «Операционные системы» / сост. Е. А. Вахрушева. - Ижевск: ИжГТУ, кафедра «Вычислительная техника», 2013. - 55 с.

2. Пирогов В. Ю. Ассемблер для Windows. -- СПб.: - Петербург, 2002 г.

3. Пирогов В. Ю. Ассемблер. Учебный курс. -- СПб.: БХВ-Петербург, 2003 г.

Размещено на Allbest.ru