Windows API 入門 (一)：句柄、實例、事件驅動核心概念

從 DOS 到 Windows 的範式轉移

DOS 程式：循序執行、直接操作硬體、單任務。
Windows 程式：事件驅動、共享硬體資源、多任務、GUI 介面。

核心概念：句柄

句柄是 Windows 核心物件的不透明識別碼 (32/64 位整數)，用於參考系統管理的資源。應用程式不可直接解讀句柄值，只能傳遞給 API。

常見句柄類型表

事件驅動機制

1. 使用者操作 (鍵盤/滑鼠) 或系統事件 (定時器、網路封包) 產生訊息。
2. 訊息投遞到執行緒訊息佇列。
3. 應用程式訊息迴圈 取出訊息：GetMessage → TranslateMessage → DispatchMessage。
4. DispatchMessage 將訊息送達目標視窗的視窗程序。
5. 視窗程序根據訊息類型執行對應邏輯。

關鍵訊息範例

• 按鍵輸入 → WM_KEYDOWN / WM_CHAR / WM_KEYUP。
• 滑鼠移動 → WM_MOUSEMOVE。
• 滑鼠左鍵點擊 → WM_LBUTTONDOWN / WM_LBUTTONUP / WM_CLICK (由系統合成)。
• 視窗需重繪 → WM_PAINT。
• 定時器觸發 → WM_TIMER。

WinMain 入口點

int WINAPI WinMain(
    HINSTANCE hInstance,      // 當前實例句柄
    HINSTANCE hPrevInstance,  // Win32 恆為 NULL (16 位相容)
    LPSTR lpCmdLine,          // 命令列參數字串
    int nCmdShow              // 視窗初始顯示狀態 (SW_SHOWDEFAULT 等)
)

• hInstance：模組在進程空間的基址，也是資源載入的鍵值。
• 同一 EXE 多次啟動 → 多個進程，各有不同 hInstance (ASLR 下更明顯)。

第一個 API 程式骨架

#include 

int WINAPI WinMain(HINSTANCE hInst, HINSTANCE, LPSTR, int nShow)
{
    MessageBox(NULL, TEXT("Hello Windows API!"), TEXT("First API"), MB_OK);
    return 0;
}

學習路徑建議

1. 掌握 句柄、訊息、視窗程序、訊息迴圈 四大支柱。
2. 熟練 CreateWindow, RegisterClass, GetMessage, DispatchMessage, DefWindowProc 五大核心 API。
3. 實作：視窗建立 → 繪製文字 → 回應滑鼠/鍵盤 → 選單/對話框 → GDI 繪圖 → 多執行緒 → DLL/COM。
4. 工具：Spy++ (訊息監控), Dependency Walker (DLL 相依), Windows SDK 文件 (權威參考)。

理解句柄與事件驅動，是跨越 DOS 思維、進入 Windows 系統程式設計大門的鑰匙。