什么是 Windows API？
Windows API (Application Programming Interface) 是微软为 Windows 操作系统提供的一套丰富的函数、宏、数据结构和消息集，它就像是 Windows 操作系统为应用程序开发者提供的一本“说明书”和一套“工具箱”，让 C/C++ 等语言编写的程序能够与 Windows 内核进行交互，实现创建窗口、绘制图形、管理文件、处理网络、操作硬件等各种复杂功能。
（图片来源网络，侵删）
核心概念：程序如何与 Windows 交互？
理解 Windows API 的工作原理至关重要，它主要围绕以下几个核心概念：
入口点：WinMain
与控制台应用程序的 main 函数不同，标准的 Windows GUI 应用程序从 WinMain 函数开始执行。
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow) {
// 程序的主要逻辑
return 0; // 返回 0 表示成功
}
HINSTANCE hInstance: 当前模块的实例句柄，可以理解为程序在内存中的“身份证号”。HINSTANCE hPrevInstance: 在 16 位 Windows 中用于判断是否有前一个实例，在现代 32/64 位系统中始终为NULL。LPSTR lpCmdLine: 命令行参数，以字符串形式提供。int nCmdShow: 指定窗口如何显示（SW_SHOW正常显示，SW_HIDE隐藏）。
句柄
句柄是 Windows API 中最重要的概念之一，它是一个唯一的、由系统生成的整数值（或指针），用于标识一个对象，操作系统通过句柄来管理各种资源，比如窗口、图标、光标、画笔、文件等。
- HWND (Handle to a Window): 窗口句柄，唯一标识一个窗口。
- HDC (Handle to a Device Context): 设备上下文句柄，用于在窗口上进行绘图。
- HINSTANCE (Handle to an Instance): 实例句柄，标识一个模块（通常是 .exe 或 .dll）。
- HBITMAP (Handle to a Bitmap): 位图句柄。
- HANDLE: 通用句柄类型，可以代表文件、互斥体、线程等多种对象。
核心思想：你的程序不直接操作对象本身，而是持有对象的“钥匙”（句柄），然后把这个“钥匙”交给 Windows API 函数，让函数去操作真正的对象。
（图片来源网络，侵删）
消息循环
Windows 是一个事件驱动的操作系统，程序大部分时间都在“等待”用户或系统发生的事件（如点击鼠标、按下键盘、窗口大小改变等），这些事件都以“消息”的形式被放入应用程序的“消息队列”中，程序需要一个“消息循环”来不断地从队列中取出消息，并分发给对应的窗口函数进行处理。
// 消息循环的伪代码
MSG msg;
while (GetMessage(&msg, NULL, 0, 0)) {
TranslateMessage(&msg); // 翻译某些键盘消息
DispatchMessage(&msg); // 将消息发送给窗口过程
}
GetMessage: 从消息队列中获取一个消息，如果队列为空，它会阻塞程序，直到有新消息。TranslateMessage: 进行一些键盘消息的转换（如将 WM_KEYDOWN 转换为 WM_CHAR）。DispatchMessage: 将消息传递给创建该窗口时注册的窗口过程函数。
窗口过程
窗口过程是一个回调函数,由程序员编写，但由 Windows 系统调用，它负责处理发送到特定窗口的所有消息。
LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam) {
switch (uMsg) {
case WM_PAINT: {
// 绘制窗口内容
PAINTSTRUCT ps;
HDC hdc = BeginPaint(hwnd, &ps);
// ... 在 hdc 上进行绘图操作 ...
FillRect(hdc, &ps.rcPaint, (HBRUSH)(COLOR_WINDOW + 1));
EndPaint(hwnd, &ps);
return 0;
}
case WM_DESTROY: {
// 当窗口被销毁时发送
PostQuitMessage(0); // 发送一个 WM_QUIT 消息，让 GetMessage 返回 0
return 0;
}
// 处理其他消息...
}
return DefWindowProc(hwnd, uMsg, wParam, lParam); // 对于未处理的消息，调用默认处理
}
一个经典的 "Hello, Windows!" 示例
下面是一个完整的、最基础的 Windows GUI 程序，它会创建一个窗口并显示出来，请仔细阅读代码中的注释，它包含了前面提到的所有核心概念。
#include <windows.h>
// 1. 窗口过程函数的声明
LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam);
// 2. 程序入口点
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow) {
// 3. 注册窗口类
WNDCLASS wc = {0};
wc.lpfnWndProc = WindowProc; // 窗口过程函数地址
wc.hInstance = hInstance;
wc.lpszClassName = L"SampleWindowClass"; // 窗口类名
wc.hCursor = LoadCursor(NULL, IDC_ARROW); // 使用标准箭头光标
if (!RegisterClass(&wc)) {
MessageBox(NULL, L"窗口类注册失败!", L"错误", MB_ICONERROR);
return 1;
}
// 4. 创建窗口
HWND hwnd = CreateWindowEx(
0, // 扩展样式
L"SampleWindowClass", // 窗口类名
L"Hello, Windows!", // 窗口标题
WS_OVERLAPPEDWINDOW, // 窗口样式
CW_USEDEFAULT, CW_USEDEFAULT, // 初始 x, y 坐标
500, 400, // 初始宽度, 高度
NULL, // 父窗口句柄
NULL, // 菜单句柄
hInstance, // 实例句柄
NULL // 附加创建参数
);
if (hwnd == NULL) {
MessageBox(NULL, L"窗口创建失败!", L"错误", MB_ICONERROR);
return 1;
}
// 5. 显示和更新窗口
ShowWindow(hwnd, nCmdShow);
UpdateWindow(hwnd);
// 6. 消息循环
MSG msg;
while (GetMessage(&msg, NULL, 0, 0)) {
TranslateMessage(&msg);
DispatchMessage(&msg);
}
// 当 GetMessage 返回 0 时，程序结束
return (int)msg.wParam;
}
// 7. 窗口过程函数的实现
LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam) {
switch (uMsg) {
case WM_DESTROY: {
// 当用户点击窗口的 'X' 按钮时，系统会发送 WM_DESTROY 消息
// 我们调用 PostQuitMessage 来请求应用程序退出
PostQuitMessage(0);
return 0;
}
}
// 对于我们没有处理的任何消息，都交给系统默认的窗口过程处理
return DefWindowProc(hwnd, uMsg, wParam, lParam);
}
如何编译这个程序？
（图片来源网络，侵删）
你需要一个 C 编译器，并且链接 Windows 库。
-
使用 Visual Studio (推荐):
- 创建一个新的 "Windows 桌面应用程序" 项目。
- 将上面的代码复制到主
.cpp文件中。 - 直接按
F5编译运行。
-
使用 MinGW (GCC) 命令行:
# -mwindows 表示链接 Windows GUI 子系统 gcc -mwindows your_source_file.c -o your_program.exe
Windows API 函数分类
Windows API 函数数量庞大，但可以按功能大致分为以下几类：
| 类别 | 描述 | 常用函数示例 |
|---|---|---|
| 窗口管理 | 创建、显示、移动、调整、销毁窗口，以及管理父子窗口关系。 | CreateWindowEx, ShowWindow, MoveWindow, DestroyWindow |
| 图形设备接口 | 在窗口上绘制文本、线条、形状和图像。 | CreateFont, TextOut, LineTo, Rectangle, Ellipse, BitBlt |
| 图形设备接口 | 在窗口上绘制文本、线条、形状和图像。 | CreateFont, TextOut, LineTo, Rectangle, Ellipse, BitBlt |
| 控件与对话框 | 创建和管理按钮、编辑框、列表框等标准控件。 | CreateWindow (创建控件), DialogBox, GetDlgItemText, SendMessage |
| 菜单与资源 | 创建和管理菜单栏、右键菜单等。 | CreateMenu, AppendMenu, LoadMenu, SetMenu |
| 文件与I/O | 对文件、目录、驱动器进行读写和查询。 | CreateFile, ReadFile, WriteFile, FindFirstFile, GetFileAttributes |
| 内存管理 | 分配和释放内存块。 | VirtualAlloc, GlobalAlloc, LocalAlloc, memcpy, free |
| 进程与线程 | 创建、管理进程和线程，进行同步（如互斥体、事件）。 | CreateProcess, CreateThread, WaitForSingleObject, CreateMutex, CreateEvent |
| 注册表 | 读写和删除 Windows 注册表中的数据。 | RegOpenKeyEx, RegQueryValueEx, RegSetValueEx, RegCloseKey |
| 网络 | 进行网络通信、获取主机信息等。 | WSAStartup, socket, connect, send, recv, gethostbyname |
| 系统信息 | 获取系统版本、CPU信息、内存状态等。 | GetVersionEx, GetSystemInfo, GlobalMemoryStatusEx |
| 定时器 | 创建定时器，在指定时间间隔后产生消息。 | SetTimer, KillTimer |
| 消息与命令 | 发送和接收消息。 | PostMessage, SendMessage, GetMessage, DispatchMessage |
学习资源与建议
-
官方文档 (MSDN / Microsoft Docs):
- 这是学习 Windows API 最权威、最准确的来源。
- 地址: https://docs.microsoft.com/zh-cn/windows/win32/api/
- 每个函数、结构体、宏都有详细的说明、参数描述、返回值和代码示例。
-
书籍:
- 《Windows 程序设计》(Programming Windows, Charles Petzold 著): 被誉为 Windows API 编程的“圣经”，非常经典，适合从零开始系统学习。
- 《Windows 核心编程》(Windows via C/C++, Jeffrey Richter 著): 更深入，适合有一定基础后阅读，探讨了许多底层原理。
-
在线教程与社区:
- The Forger's Win32 API Tutorial: 一个非常经典的在线入门教程。
- Stack Overflow: 当你遇到具体问题时，这里是寻找答案的最佳去处。
现代替代方案：.NET 与 WinUI
虽然直接使用 Windows API 是最底层、最灵活的方式，但对于大多数新的桌面应用开发，微软提供了更高级的框架：
- .NET: 使用 C# 或 F#，通过 Windows Forms (较老) 或 WPF (较新) 来构建 UI，这些框架封装了复杂的 Windows API 调用，大大提高了开发效率。
- WinUI 3: 微软最新的原生 UI 框架，采用 C++ 和 WinUI 组件，旨在提供现代、美观且可定化的用户界面，同时保留对 Windows API 的直接访问能力。
学习 C 语言 Windows API 是理解 Windows 操作系统工作原理、进行底层系统开发的基石，虽然现代开发有更高层次的框架，但掌握 API 能让你对程序的运行有更深刻的认识，并在性能和功能上有更大的控制权，从理解 WinMain、句柄、消息循环和窗口过程开始，逐步探索各个功能模块，是学习这门技术的有效路径。
