Visual C++ 回調函數完整解析：從函數指標到介面解耦的實戰重構

前言

回調函數是 C/C++ 實現「控制反轉」、解耦演算法與具體處理邏輯的核心技術。本文從函數指標基礎語法出發，透過「檔案上傳進度回調」實戰案例，展示如何將「資料傳輸」與「介面顯示」分離，實現高內聚、低耦合的模組化設計。

回調函數基礎語法

// 1. 定義函數指標型別
typedef int (*CallBack)(char *p);

// 2. 回調函數實作
int A(char *p) { /* 處理邏輯 */ return 0; }

// 3. 使用回調的操作函數
void B(CallBack lpCall, char *pProvide) {
    // ... 自身邏輯 ...
    lpCall(pProvide);  // 呼叫回調
    // ... 後續邏輯 ...
}

// 4. 實際呼叫
char *p = "hello!";
CallBack myCallBack = A;
B(myCallBack, p);

實戰案例：檔案上傳進度回調重構

耦合版本：資料與介面混雜

class CUploadFile : public CDialog {
    int Send(LPCTSTR lpServerIP, LPCTSTR lpServerPort, LPCTSTR UploadFilePath);
    static int GetCurState(int nCurDone, int nInAll, void *pParam); // 靜態成員作為回調
};

int CUploadFile::Send(...) {
    int ret = Upload(data, GetCurState, this, ...); // 傳入 this 指標
}

int CUploadFile::GetCurState(int nCurData, int nInAll, void *pParam) {
    CUploadFile* pThis = (CUploadFile*)pParam;
    // 直接操作 pThis 介面控件 (進度條、文字)
    return 0;
}

缺點：CUploadFile 同時負責網路傳輸與 UI 更新，難以復用、單元測試、替換介面實現。

解耦重構：分離資料層與介面層

資料上傳類：純邏輯，零 UI 依賴

class CUploadData {
public:
    typedef int (*SetUploadCaller)(int nCurData, int nInAll, void *pParam);
    
    int UploadFile(LPCTSTR lpFileNamePath, LPVOID lparam, SetUploadCaller Caller);
    int Send(LPCTSTR lpServerIP, LPCTSTR lpServerPort, LPCTSTR UploadFilePath);
    // 移除 GetCurState，不再包含任何 UI 邏輯
};

介面顯示類：持有資料物件，提供回調實現

class CShowGUI : public CDialog {
public:
    typedef int (*SetUploadCaller)(int nCurData, int nInAll, void *pParam);
    
    void SetCallBack(LPCTSTR strPath);
    static int GetCurState(int nCurData, int nInAll, void *pParam); // 介面層回調
    
    CUploadData m_UploadData; // 組合關係
};

void CShowGUI::SetCallBack(LPCTSTR strPath) {
    SetUploadCaller myCaller = GetCurState; // 取得介面層回調位址
    m_UploadData.UploadFile(strPath, this, myCaller); // 傳入 this 供回調使用
}

int CShowGUI::GetCurState(int nCurData, int nInAll, void *pParam) {
    CShowGUI* pThis = (CShowGUI*)pParam;
    // 更新進度條、顯示文字、計算速度等純 UI 操作
    return 0;
}

關鍵設計模式對照

進階議題：類成員函數作為回調

C++ 非靜態成員函數帶有隱含 this 指標，無法直接轉為普通函數指標。解決方案：

1. 靜態成員函數 + void* pParam 傳遞 this (本文採用)
2. std::function + std::bind / lambda (C++11+)
3. 靜態 thunk 函數 + 成員函數指標 (ATL/WTL 常用)

實戰經驗總結

1. 回調介面最小化：只傳遞必要資料 (進度、總量、使用者資料指標)
2. 生命週期管理：確保回調執行時 pParam 指向的物件仍有效
3. 執行緒安全：若回調在背景執行緒觸發，UI 更新需 PostMessage 或同步機制切換至 UI 執行緒
4. 錯誤傳播：回調回傳值可用於通知上層取消/重試/錯誤

總結

回調函數是 C/C++ 實現「好萊塢原則」——Don't call us, we'll call you 的基石。透過函數指標將「控制流」與「業務邏輯」分離，配合 void* pParam 傳遞上下文，即可構建高度可復用、可測試、可擴展的模組化架構。現代 C++ 建議優先使用 std::function + lambda，獲得型別安全與閉包捕獲能力。