Win32 SDK程式設計核心架構完整解析：從WinMain到訊息迴圈的底層邏輯

MFC雖封裝了Win32 API，但其核心架構仍繼承自Windows SDK（可追溯至Windows 3.x時代）。理解SDK程式結構是掌握Win32開發、除錯MFC深層問題、甚至開發高效能系統級程式的關鍵。本文完整剖析標準SDK程式的 WinMain、視窗類別註冊、視窗建立、訊息迴圈與視窗程序四大支柱。

完整SDK程式範例

int CALLBACK WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,
                     LPSTR lpCmdLine, int nCmdShow)
{
    MSG msg;
    if (!hPrevInstance)
        if (!InitApplication(hInstance))
            return FALSE;
    if (!InitInstance(hInstance, nCmdShow))
        return FALSE;
    
    while (GetMessage(&msg, NULL, 0, 0)) {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }
    return msg.wParam;
}

BOOL InitApplication(HINSTANCE hInstance)
{
    WNDCLASS wc = {0};
    wc.style         = CS_HREDRAW | CS_VREDRAW;
    wc.lpfnWndProc   = (WNDPROC)WndProc;
    wc.cbClsExtra    = 0;
    wc.cbWndExtra    = 0;
    wc.hInstance     = hInstance;
    wc.hIcon         = LoadIcon(hInstance, "MyIcon");
    wc.hCursor       = LoadCursor(NULL, IDC_ARROW);
    wc.hbrBackground = GetStockObject(WHITE_BRUSH);
    wc.lpszMenuName  = "GenericMenu";
    wc.lpszClassName = "MyWindowClass";
    return RegisterClass(&wc);
}

BOOL InitInstance(HINSTANCE hInstance, int nCmdShow)
{
    HWND hWnd = CreateWindow("MyWindowClass", "Win32 SDK Demo",
        WS_OVERLAPPEDWINDOW, CW_USEDEFAULT, CW_USEDEFAULT,
        CW_USEDEFAULT, CW_USEDEFAULT, NULL, NULL, hInstance, NULL);
    if (!hWnd) return FALSE;
    ShowWindow(hWnd, nCmdShow);
    UpdateWindow(hWnd);
    return TRUE;
}

LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
{
    switch (message) {
        case WM_DESTROY:
            PostQuitMessage(0);
            break;
        default:
            return DefWindowProc(hWnd, message, wParam, lParam);
    }
    return 0;
}

WinMain 參數深度解析

實例 = 程式邏輯在記憶體中的一次具體執行實體。三顆蘋果 = 「蘋果」類別的三個實例。控制碼 = 32位整數，代表核心物件的間接參考。

兩階段初始化流程

階段 1：InitApplication — 註冊視窗類別

「視窗類別」是視窗的模板/藍圖，非C++類別。RegisterClass(&WNDCLASS) 向系統登錄：

階段 2：InitInstance — 建立視窗實例

HWND CreateWindow(
    LPCTSTR lpClassName,  // 註冊時的lpszClassName
    LPCTSTR lpWindowName, // 標題列文字
    DWORD dwStyle,        // WS_OVERLAPPEDWINDOW等
    int x, int y,         // 位置
    int nWidth, int nHeight, // 大小
    HWND hWndParent,      // 父視窗
    HMENU hMenu,          // 選單/控制項ID
    HINSTANCE hInstance,  // 實例控制碼
    LPVOID lpParam        // 建立參數傳給WM_CREATE
);

• 成功回傳 HWND（視窗控制碼），失敗回傳 NULL
• 建立後不自動顯示，需 ShowWindow() + UpdateWindow() 強制重繪

訊息迴圈——Windows事件驅動核心

while (GetMessage(&msg, NULL, 0, 0)) {
    TranslateMessage(&msg);
    DispatchMessage(&msg);
}

GetMessage 行為

• 從執行緒訊息佇列取出訊息填入 MSG 結構
• 佇列為空時阻塞等待（節省CPU）
• 收到 WM_QUIT 回傳 FALSE（0），結束迴圈
• 其他訊息回傳 TRUE（非零）

TranslateMessage 鍵盤轉譯

• 將虛擬鍵訊息轉為字元訊息：
• WM_KEYDOWN + WM_KEYUP → WM_CHAR / WM_DEADCHAR
• WM_SYSKEYDOWN + WM_SYSKEYUP → WM_SYSCHAR / WM_SYSDEADCHAR
• 轉譯後字元訊息重新放入佇列尾端

DispatchMessage 分派機制

1. 從 MSG.hwnd 取得目標視窗控制碼
2. 查找該視窗屬於哪個視窗類別
3. 取得該類別註冊時的 lpfnWndProc
4. 呼叫 WndProc(hwnd, msg, wParam, lParam)

視窗程序——訊息處理中樞

LRESULT CALLBACK WndProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
    switch (uMsg) {
        case WM_CREATE:      // 視窗建立時
            // 初始化資源、建立子控制項
            break;
        case WM_PAINT:       // 需重繪
            { PAINTSTRUCT ps; HDC hdc = BeginPaint(hWnd, &ps); /* 繪圖 */ EndPaint(hWnd, &ps); }
            break;
        case WM_COMMAND:     // 選單/控制項通知
            switch (LOWORD(wParam)) { case IDM_EXIT: DestroyWindow(hWnd); break; }
            break;
        case WM_DESTROY:     // 視窗銷毀
            PostQuitMessage(0); // 發送WM_QUIT給訊息佇列
            break;
        default:
            return DefWindowProc(hWnd, uMsg, wParam, lParam); // 預設處理
    }
    return 0;
}

訊息參數編碼規則

• wParam、lParam 依訊息類型語意不同（查閱 WinUser.h 或 MSDN）
• 常用宏：LOWORD(lParam)、HIWORD(lParam)、GET_X_LPARAM(lParam)、GET_Y_LPARAM(lParam)
• 自訂訊息：WM_USER + n（視窗私有）、RegisterWindowMessage（系統全域唯一）

SDK vs MFC 架構對照

常見陷阱與最佳實踐

1. Unicode/ANSI：統一專案字元集，API帶 W/A 後綴或用 TCHAR 宏
2. 視窗程序不可阻塞：耗時操作另開執行緒，否則界面凍結
3. 資源洩漏：Create 配對 Destroy/Delete（DC、筆刷、字型、位圖...）
4. 重繪閃爍：WM_ERASEBKGND 回傳非零、雙緩衝繪圖
5. DPI感知：Manifest宣告 dpiAware，使用 GetDpiForWindow 縮放

總結

Win32 SDK以 實例控制碼 → 視窗類別註冊 → 視窗建立 → 訊息迴圈 → 視窗程序 五步構成完整程式骨架。MFC在此基礎上以C++類別封裝Handle、以訊息映射巨集替代Switch分派、以文檔/視圖架構組織應用邏輯。深入理解SDK層機制，才能在MFC無法覆蓋場景下靈活介入底層、解決疑難雜症、編寫高效能系統程式。