1. Введение
2. Секция импорта
3. Структуры
4. API-функции
5. Ссылки

Эта статья основана на коде Томаша Грыштара (Tomasz Grysztar) [Ссылка на исходники] и написана исключительно в образовательных целях. Она объясняет работу ассемблерного кода, который создает снимки экрана в формате JPEG.

Описание структур и API-функции преимущественно является переводом описаний с MSDN.

Пост на FlatAssembler.net

section '.rdata' data readable

; импортируемые функции и библиотеки
data import
  library                           \
    kernel32,       'KERNEL32.DLL', \
    user32,         'USER32.DLL',   \
    gdi32,          'GDI32.DLL',    \
    gdiplus,        'GDIPLUS.DLL'

  import  gdiplus,                                               \
    GdiplusStartup,               'GdiplusStartup',              \
    GdiplusShutdown,              'GdiplusShutdown',             \
    GdipGetImageEncodersSize,     'GdipGetImageEncodersSize',    \
    GdipGetImageEncoders,         'GdipGetImageEncoders',        \
    GdipSaveImageToFile,          'GdipSaveImageToFile',         \
    GdipDisposeImage,             'GdipDisposeImage',            \
    GdipCreateBitmapFromHBITMAP,  'GdipCreateBitmapFromHBITMAP'

  include 'api/kernel32.inc'
  include 'api/user32.inc'
  include 'api/gdi32.inc'
end data

Программа представлена двумя структурами:

• GdiplusStartupInput
• ImageCodecInfo

[Описание на MSDN]

Структура, содержащая блок аргументов, требуемых для функции GdiplusStartup.

Синтаксис:

typedef struct GdiplusStartupInput {
  UINT32         GdiplusVersion;
  DebugEventProc DebugEventCallback;
  BOOL           SuppressBackgroundThread;
  BOOL           SuppressExternalCodecs;
};

Объявление структуры в FASM:

struct GdiplusStartupInput
  GdiplusVersion           dd ?
  DebugEventCallback       dd ?
  SuppressBackgroundThread dd ?
  SuppressExternalCodecs   dd ?
ends

Члены структуры представлены в таблице ниже:

Структура GdiplusStartupInput предоставляет конструктор, который устаналивает член структуры GdiplusVersion в 1 и позволяет указать значения для остальных трех членов. Все параметры конструктора являются необязательными, поэтому можно объявить перменную типа GdiplusStartupInput без передачи каких-либо аргументов конструктору, и все члены будут инициализированы соответствующими значениями по умолчанию.

[Описание на MSDN]

Структура ImageCodecInfo предоставляет информацию об установленных кодеках изображения.

Синтаксис:

typedef struct ImageCodecInfo {
   CLSID ClassID;
   GUID FormatID;
   WCHAR * CodecName;
   WCHAR * DllName;
   WCHAR * FormatDescription;
   WCHAR * FilenameExtension;
   WCHAR * MimeType;
   DWORD Flags;
   DWORD Version;
   DWORD SigCount;
   DWORD SigSize;
   BYTE * SigPattern;
   BYTE * SigMask;
};

Объявление структуры в FASM:

struct ImageCodecInfo
  Clsid             db 16 dup ?
  FormatID          db 16 dup ?
  CodecName         dd ?
  DllName           dd ?
  FormatDescription dd ?
  FilenameExtension dd ?
  MimeType          dd ?
  Flags             dd ?
  Version           dd ?
  SigCount          dd ?
  SizeSize          dd ?
  SigPattern        dd ?
  SigMask           dd ?
ends

Члены структуры представлены в таблице ниже:

API-функции, использованные в программе:

• GdiplusStartup
• GdipGetImageEncodersSize
• VirtualAlloc
• GetImageEncoders
• VirtualFree
• GetDC
• GetSystemMetrics
• CreateCompatibleBitmap
• CreateCompatibleDC
• SelectObject
• BitBlt
• GdipCreateBitmapFromHBITMAP
• GdipSaveImageToFile
• GdipDisposeImage
• DeleteObject
• ReleaseDC
• GdiplusShutdown
• ExitProcess

[Описание на MSDN]

Функция GdiplusStartup инициализирует Windows GDI+.

Status GdiplusStartup(
  __out  ULONG_PTR token *token,
  __in   const GdiplusStartupInput *input,
  __out  GdiplusStartupOutput *output
);

Аргументы функции GdiplusStartup:

Использование в коде:

  invoke  GdiplusStartup, token, input, NULL
  test    eax, eax
  jnz     exit

[Описание на MSDN]

Функция GdipGetImageEncodersSize получает число доступных кодировщиков изображения и размер массива объектов типа ImageCodecInfo, который возвращает функция GetImageEncoders.

Синтаксис:

Status GetImageEncodersSize(
  __out  UINT *numEncoders,
  __out  UINT *size
);

Аргументы функции GdipGetImageEncodersSize:

Использование в коде:

  invoke  GdipGetImageEncodersSize, encoders_count, encoders_size
  test    eax, eax
  jnz     gdiplus_shutdown

[Описание на MSDN]

С помощью данной функции есть возможность выделить или зарезервировать страницы виртуальной памяти. Между выделением и резервированием есть разница. При выделении физически выделяется память и естественно увеличивается файл подкачки. При резервировании этого не происходит.

Синтаксис:

LPVOID WINAPI VirtualAlloc(
  _In_opt_ LPVOID lpAddress,
  _In_     SIZE_T dwSize,
  _In_     DWORD  flAllocationType,
  _In_     DWORD  flProtect
);

Аргументы функции VirtualAlloc:

Способ получения:

Тип доступа:

Использование в коде:

  invoke  VirtualAlloc, 0, [encoders_size], MEM_COMMIT, PAGE_READWRITE
  test    eax, eax
  jz      gdiplus_shutdown
  mov     ebx, eax

[Описание на MSDN]

Функция GetImageEncoders получает массив объектов типа ImageCodecInfo, которые содержат информацию о доступных кодировщиках изображений.

Синтаксис:

Status GetImageEncoders(
  __in   UINT numEncoders,
  __in   UINT size,
  __out  ImageCodecInfo *encoders
);

Аргументы функции:

Использование в коде:

  invoke  GdipGetImageEncoders, [encoders_count], [encoders_size], ebx
  test    eax, eax
  jnz     gdiplus_shutdown

[Описание на MSDN]

Функция VirtualFree освобождает выделенную память.

Синтаксис:

BOOL VirtualFree
(  
  LPVOID lpAddress,
  SIZE_T dwSize,	
  DWORD dwFreeType	
);

Аргументы функции:

Типы операций с памятью:

Использование в коде:

invoke  VirtualFree, ebx, 0, MEM_RELEASE

[Описание на MSDN]

Функция GetDC идентифицирует контекст устройства для CWnd клиентской области если успешно иначе, возвращаемое значение NULL.

Синтаксис:

HDC GetDC(
  _In_ HWND hWnd
);

Аргументы функции:

Использование в коде:

invoke  GetDC, HWND_DESKTOP
test    eax, eax
jz      gdiplus_shutdown
mov     esi, eax

[Описание на MSDN]

Функция GetSystemMetrics идентифицирует заданный системный показатель или настройку конфигурации системы.

Синтаксис:

int WINAPI GetSystemMetrics(
  _In_ int nIndex
);

Аргументы функции:

Использование в коде:

invoke  GetSystemMetrics, SM_CYSCREEN
mov     [screen_height], eax
invoke  GetSystemMetrics,SM_CXSCREEN
mov     [screen_width], eax

[Описание на MSDN]

Функция CreateCompatibleBitmap создает точечный рисунок, совместимый с контекстом устройства.

Синтаксис:

HBITMAP CreateCompatibleBitmap(
  _In_ HDC hdc,
  _In_ int nWidth,
  _In_ int nHeight
);

Аргументы функции:

Использование в коде:

invoke  CreateCompatibleBitmap, esi, [screen_width], [screen_height]
test    eax, eax
jz      release_desktop_dc
mov     ebx, eax

[Описание на MSDN]

Функция CreateCompatibleDC создает контекст устройства памяти, который является совместимым с устройством, определенным pDC.

Синтаксис:

HDC CreateCompatibleDC(
  _In_ HDC hdc
);

Аргументы функции:

Использование в коде:

invoke  CreateCompatibleDC, esi
test    eax, eax
jz      delete_bitmap
mov     edi, eax

[Описание на MSDN]

Функция SelectObject выбирает объект в указанном контексте устройства. Новый объект заменяет предыдущий объект того же типа.

Синтаксис:

HGDIOBJ SelectObject(
  _In_ HDC     hdc,
  _In_ HGDIOBJ hgdiobj
);

Аргументы функции:

Использование в коде:

invoke  SelectObject, edi, ebx
test    eax, eax
jz      delete_dc

[Описание на MSDN]

Функция BitBlt копирует точечный рисунок от исходного контекста устройства до этого текущего контекста устройства.

Синтаксис:

BOOL BitBlt(
  _In_ HDC   hdcDest,
  _In_ int   nXDest,
  _In_ int   nYDest,
  _In_ int   nWidth,
  _In_ int   nHeight,
  _In_ HDC   hdcSrc,
  _In_ int   nXSrc,
  _In_ int   nYSrc,
  _In_ DWORD dwRop
);

Аргументы функции:

Использование в коде:

invoke  BitBlt, edi, 0, 0, [screen_width], [screen_height], esi, 0, 0, SRCCOPY
test    eax, eax
jz      delete_dc

[Описание на MSDN]

Функция GdipCreateBitmapFromHBITMAP создает точечное изображение на основе дескриптора GDI и дескриптора палитры GDI.

Синтаксис:

GpStatus WINGDIPAPI GdipCreateBitmapFromHBITMAP(
    HBITMAP hbm,
    HPALETTE hpal,
    GpBitmap** bitmap
);

Аргументы функции:

Использование в коде:

invoke  GdipCreateBitmapFromHBITMAP, ebx, NULL, gdip_bitmap
test    eax, eax
jnz     delete_dc

[Описание на MSDN]

Функция GdipSaveImageToFile сохраняет изображение в файл.

Синтаксис:

GpStatus WINGDIPAPI GdipSaveImageToFile(
    GpImage *image,
    GDIPCONST WCHAR* filename,
    GDIPCONST CLSID* clsidEncoder,
    GDIPCONST EncoderParameters* encoderParams
);

Аргументы функции:

Использование в коде:

invoke  GdipSaveImageToFile, [gdip_bitmap], file_name, encoder_clsid, NULL

[Описание на MSDN]

Функция GdipDisposeImage удаляет указанное изображение.

Синтаксис:

GpStatus WINGDIPAPI GdipDisposeImage(
    GpImage *image
);

Аргументы функции:

Использование в коде:

invoke  GdipDisposeImage, [gdip_bitmap]

[Описание на MSDN]

Функция DeleteObject удаляет перо, кисть, шрифт, растровое изображение, область или палитру, освобождая все системные ресурсы, связанные с объектом. После удаления объекта указанный дескриптор более недействителен.

Синтаксис:

BOOL DeleteObject(
  _In_ HGDIOBJ hObject
);

Аргументы функции:

Использование в коде:

invoke  DeleteObject, edi

[Описание на MSDN]

Функция ReleaseDC освобождает контекст устройства (DC) для его использования другими приложениями.

Синтаксис:

int ReleaseDC(
  _In_ HWND hWnd,
  _In_ HDC  hDC
);

Аргументы функции:

Использование в коде:

invoke  ReleaseDC, HWND_DESKTOP, esi

[Описание на MSDN]

Функция GdiplusShutdown очищает ресурсы, используемые Windows GDI+.

Синтаксис:

void GdiplusShutdown(
  __in  ULONG_PTR token
);

Аргументы функции:

Использование в коде:

invoke  GdiplusShutdown, [token]

[Описание на MSDN]

Функция ExitProcess заканчивает работу процесса и всех его потоков.

Синтаксис:

VOID ExitProcess(
  UINT uExitCode	
);

Аргументы функции:

Использование в коде:

invoke  ExitProcess, 0