C++Builder 整合 DirectX SDK 開發環境配置指南

環境假設

• C++Builder 安裝路徑：C:\Borland\CBuilder\
• DirectX SDK 安裝路徑：C:\dx5sdk\ (範例為 DX5，新版同理)

關鍵問題：標頭檔衝突

BCB 自帶 Include 目錄下已有舊版 DirectX 標頭 (如 ddraw.h 為 DX3 版)。若直接將 SDK include 加入專案搜尋路徑，編譯器會優先找到 BCB 目錄下的舊版，導致缺少新介面定義。

最佳解決方案：覆蓋法

1. 將 C:\dx5sdk\include\ 下所有檔案複製到 C:\Borland\CBuilder\Include\，覆蓋同名舊檔。
2. 這確保專案直接 #include <d3d.h> 等時使用最新 SDK 版本，無需調整搜尋順序。

庫檔處理

DX SDK 隨附的 Borland 版 .lib 可能有問題。建議：

1. 從可信來源下載經驗證的 BCB 相容 .lib (如 dx5_bcb_libs.zip)。
2. 解壓至 C:\Borland\CBuilder\Lib\ (或 Lib\PSDK)，覆蓋舊檔。

專案建立正確姿勢

1. 新建 Console Application (主控台應用程式)。
2. 專案選項 → Linker → Target: Win32 GUI (而非 Console)。
3. 自行撰寫 WinMain、WndProc 進入點。
4. 切勿 使用「DirectX Application」等專案模板，會引入難以排查的設定問題。

必要的預處理器定義

在每個使用 DirectX 標頭的 .cpp 最前面 (或專案條件定義) 加入：

#if defined(__BORLANDC__) && defined(__WIN32__)
#define _WIN32
#endif

// 若仍有編譯錯誤，嘗試追加
#define WIN32
#define WIN95

原因：BCB 對 _WIN32 等巨集處理較舊，DirectX 標頭依賴此巨集啟用正確定義。

驗證編譯

建立最小 DirectDraw/Direct3D 初始化程式，確認無「未定義識別符」、「庫檔格式錯誤」等問題。

現代補充

• DirectX 9/10/11/12 SDK 已整合至 Windows SDK (10.0+)，無需獨立安裝。
• BCB 10.x+ (RAD Studio) 專案建議直接在 SDK 管理器勾選 Windows SDK 版本，IDE 自動配置路徑。
• 舊版 BCB 維護專案時，上述覆蓋法仍是最省力方案。