文章編號: 154093 - 上次校閱: 2006年11月21日 - 版次: 3.3

如何從 Windows 95、 Windows 98 或 Windows 千禧版下 16 位元程式碼呼叫 32 位元的程式碼

系統提示本文適用於您使用的作業系統之外的作業系統。與您不相關的文章內容已停用。

它是通常需要將連接埠 Win16 應用程式和 DLL Win32 有點一次而非一次。比方說您可以連接埠 Win32 的 16 位元 DLL，但是仍然能夠從 16 位元程式碼呼叫。本文將告訴您，16 位元 DLL 可以呼叫 32 位元 DLL 的機制。機制稱為一個 Thunk 和方法實作下 Microsoft Windows 95，Windows 98 或 Windows 千禧版 (Me) 稱為平面 Thunk。

在撰寫 Thunk 程式碼三個主要步驟如下：

正在建立 Thunk 指令碼。
建置 16 位元 DLL。
建置 32 位元 DLL。

回此頁最上方

其他相關資訊

平面 Thunk 是由 16 位元和 32 位元 DLL，一起工作所組成。16 位元 DLL 和 16 位元 DLL 呼叫中 32 位元 DLL 匯出的函式 A Win16 應用程式呼叫。在 32 位元 DLL 函式傳回時, 它會傳回回到 16 位元 DLL 會輪流傳回回到 Win16 應用程式。16 位元和 32 位元 DLL 工作藉由呼叫 Windows 95、 Windows 98 或 Windows Me 16 位元和 32 位元 kernels 來處理所有讓從 16 位元到 32 位元的程式碼轉換以及備份所需的低階詳細資料。

設計新的平面 Thunk 牽涉到建立 Thunk 指令碼 (.THK 檔案)。此指令碼以 Thunk 編譯器編譯到組件語言檔案的兩次；一次與每個兩個旗標組合:-DIS_16 和-DIS_32。結果是 16 位元和 32 位元物件模組。這些物件模組會分別連結至 16 位元和 32 位元 DLL。下列圖表摘要了參與建置 DLL 檔案：

                       +------------+
                       | 16to32.THK |
                       +------------+
                             |
                       +------------+
                       | 16to32.ASM |
                       +------------+
                        /          \ 
               -DIS_16 /            \ -DIS_32
                      /              \ 
                 +-----------+ +-----------+
                 | 16THK.OBJ | | 32THK.OBJ |
                 +-----------+ +-----------+
                       /                  \ 
      +-------+    +-------+             +-------+
      | APP16 | -> | DLL16 | -- THUNK -- | DLL32 |
      +-------+    +-------+             +-------+

回此頁最上方

建置平面 Thunk 所需的工具

Microsoft Visual C++ 1.5 x (16 位元編譯器) 的 16 位元邊的 Thunk。此 Thunk 的 16 位元側邊是 16 位元 DLL。
Microsoft Visual C++ 2.x 或更高 (32 位元編譯器) 的 32 位元邊的 Thunk。此 Thunk 的 32 位元側邊是 32 位元 DLL。
Thunk 編譯器 (thunk.exe) 從 Microsoft Win32 SDK 的編譯 Thunk 指令碼。
Microsoft 巨集組譯工具 (MASM) 6.1 或更高的組譯 Thunk 編譯器的組件語言輸出的版本。
從 BINW16 目錄 Microsoft Win32 SDK 來標示為版本 4.0 16 位元 Thunk DLL 的 16 位元 RC.EXE。

回此頁最上方

正在建立 Thunk 指令碼

您需要建立 Thunk 編譯器所用來建立一個 Thunk 的指令碼。Thunk 指令碼是包含型別定義您想要透過 Thunk 呼叫之函式的函式原型和每個函式的參數方向規格的文字檔。比方說有些函數則需要輸入和輸出參數而有些則可能只需要輸入的參數。Thunk 指令檔使用特殊的語法來描述是否輸入參數、輸出，或輸入和輸出。

16-32 Thunk > 的 Thunk 指令碼從下列的陳述式開始：

enablemapdirect1632 = true ；

預設情況下，只時第一次執行到它的 Thunk，被載入 32 位元 DLL。因為使用此晚期繫結 16 位元的程式碼必須依據任何 32 位元 DLL 的初始化，所採取的動作不是。因為 32 位元 DLL 會載入當第一個 thunk 要它執行時，在 32 位元 DLL 載入問題將會無法偵測 16 位元 DLL 第一次載入時。若要停用 32 位元 DLL 的晚期繫結，請 Thunk 指令碼中加入下列行：

preload32 = true ；

Thunk 編譯器必須將 Thunk 的 16 位元側邊宣告為 __far __pascal 和 32 位元側邊是 __stdcall。(WINAPI 宣告負責這兩面)。Thunk 編譯器不支援 __cdecl 和 __fastcall 呼叫慣例。但是，注意 Thunk 編譯器不會實際接受 __far、 __pascal 或 __stdcall 關鍵字；它們會假設。

下列的 Thunk 指令碼說明沒有參數的函式:

   enablemapdirect1632 = true;

   void MyThunk32()
   {
   }

此相等的宣告會是：

   C   language:    void WINAPI MyThunk32(void);
   C++ Language:    extern "C" void WINAPI MyThunk32();

下列的範例指令碼中的函式接受兩個參數，並傳回值。第二個參數是輸出參數，並包含傳遞回至 16 位元 DLL 的指標：

   enablemapdirect1632 = true;

   typedef int   BOOL;
   typedef char *LPSTR;

   BOOL MyThunk32(LPSTR lpstrInput, LPSTR lpstrOutput)
   {
      lpstrInput  = input;   // optional; input is default
      lpstrOutput = output;
   }

的陳述式"lpstrOutput = 輸出」會告訴 Thunk 編譯器 32 位元函數會傳回一個需要從 32 位元線性位址轉換成選取器: 位移指標的位址。

下列的 Thunk 指令碼會使用更複雜的參數型別，例如結構。本範例也示範如何指定輸入和輸出參數：

   enablemapdirect1632 = true;

   typedef unsigned int UINT;
   typedef char *LPSTR;

   typedef struct _POINT {
      UINT x;
      UINT y;
   }POINT, *LPPOINT;

   typedef struct _CIRCLE {
      POINT center;
      UINT  radius;
   }CIRCLE, *LPCIRCLE;

   void MyThunk32( LPCIRCLE lpCircleInOut)
   {
      lpCircleInOut = inout;
   }

的陳述式"lpCircleInOut = 進出」會告訴 Thunk 編譯器，將這個指標用來進行輸入和輸出。如此 Thunk 編譯器 lpCircleInOut 從 16 位元遠 (選取器: 位移) 指標時，轉換為 32 位元線性位址呼叫此函式，並在函式傳回時，再回到 16 位元的遠程指標。轉換是由 Thunk 編譯器所建立 Thunk 處理。

回此頁最上方

使用 Thunk 編譯器

Thunk 編譯器使用方式是，如下所示：

thunk.exe/選項 <inputfile>-o <outputfile>

下面這一行會示範如何編譯-32 Thunk 指令碼 > 16。這一行會採用名為 16to32.thk 指令碼，並產生名為 16to32.asm 的組件語言檔案：

Thunk-t thk 16to32.thk-o 16to32.asm

在"-t thk 」選項是告訴 Thunk 編譯器 Thunk 函式組件語言檔案與 thk_ 」中的前置詞。這個前置詞時，連結到一組 DLL 的多個 Thunk 指令碼使用，且有助於建立一組包含兩個 16-32 和 32-16 Thunk > 的 DLL。

回此頁最上方

建置 16 位元 DLL

16 位元 DLL 必須匯出函式命名 DllEntryPoint 」。這個函式必須執行名為 thk_ThunkConnect16 Thunk 編譯器所建立的函式呼叫 (thk 」是從 Thunk 編譯器-t 參數前置詞) 每次呼叫 DllEntryPoint：

   // prototype for function in .OBJ from the thunk script
   BOOL WINAPI __export thk_ThunkConnect16(LPSTR lpDll16,
                                           LPSTR lpDll32,
                                           WORD  hInst,
                                           DWORD dwReason);

    BOOL WINAPI thk_thunkConnect16(LPSTR, LPSTR, WORD, DWORD);

    BOOL WINAPI __export DllEntryPoint(DWORD dwReason,
                                       WORD  hInst,
                                       WORD  wDS,
                                       WORD  wHeapSize,
                                       DWORD dwReserved1,
                                       WORD  wReserved 2)
    {
       if (!thk_ThunkConnect16("DLL16.DLL", "DLL32.DLL",
                               hInst, dwReason))
          return FALSE;

        return TRUE;
    }

在模組定義 (DEF) 檔的匯入區段中包含下列各行為 16 位元 DLL:

   C16ThkSL01      = KERNEL.631
   ThunkConnect16  = KERNEL.651

為 16 位元 DLL，在模組定義 (.DEF) 檔的匯出區段中包含下列各行。THK_THUNKDATA16 是在組合從 Thunk 編譯器輸出的目的檔中定義的。這兩個這些符號必須有 RESIDENTNAME] 關鍵字，但是可以有任何序數編號：
THK_THUNKDATA16 @1 RESIDENTNAME DllEntryPoint @2 RESIDENTNAME
將 Win16 應用程式會呼叫的 Thunk 函數新增到匯出陳述式的 16 位元 DLL 模組定義 (DEF) 檔案。務必他們宣告，定義為 __far __pascal __export (或 WINAPI __export)。如果 DLL 以 C + + 撰寫，請務必將它們宣告為 extern"C"也。

(如果尚未編譯)，如下所示編譯 Thunk：

   thunk -t thk 16to32.thk -o 16to32.asm

接下來，組合所產生的 Thunk 編譯器做為 16 位元物件模組的組件語言檔案。下面這一行顯示一個範例：
ml /DIS_16 /c /W3 /nologo /Fo thk16.obj 16to32.asm
連結此物件模組做為 16 位元 DLL 的一部分。
將 16 位元 DLL 標記為 4.0 版。如果要執行這項操作，使用資源編譯器 (RC.EXE)。下面這一行顯示語法：
rc-40 < DLL 檔案 >
這個-40 選項僅可用資源編譯器所提供的 Win32 SDK 中。

注意：確定使用 RC.EXE BINW16 目錄中的，使 DLL 標有 4.0 版。隨附的 Microsoft Visual C++ 的 16 位元版本的 RC.EXE 不會將 DLL 標記為 4.0 版中。

回此頁最上方

建置 32 位元 DLL

在 32 位元 DLL DllMain，您必須進行命名 thk_ThunkConnect32 每次呼叫 DllMain 如下所示的 Thunk 編譯器所建立的函式的呼叫 (thk 」是從 Thunk 編譯器-t 參數前置字元):

   // prototype for function in .OBJ from the thunk script
   BOOL WINAPI thk_ThunkConnect32 (LPSTR     lpDll16,
                                   LPTSR     lpDll32,
                                   HINSTANCE hDllInst,
                                   DWORD     dwReason);

   BOOL WINAPI DllMain (HINSTANCE hDLLInst,
                        DWORD     dwReason,
                        LPVOID    lpvReserved)
   {
      if (!thk_ThunkConnect32("DLL16.DLL",
                              "DLL32.DLL",
                              hDLLInst,
                              dwReason))
      {
         return FALSE;
      }
      switch (dwReason)
      {
         case DLL_PROCESS_ATTACH:
            break;

         case DLL_PROCESS_DETACH:
            break;

         case DLL_THREAD_ATTACH:
            break;

         case DLL_THREAD_DETACH:
            break;
      }
      return TRUE;
   }

在模組定義 (.DEF) 檔的匯出區段中包含下列各行為 32 位元 DLL:
thk_ThunkData32
匯出您正在 thunking 函式。您可以使用 32 位元 DLL 模組定義 (DEF) 檔或 __declspec(dllexport) 關鍵字。務必他們宣告，定義為 __stdcall。如果 32 位元 DLL 以 C + + 撰寫，請務必將它們宣告為 extern"C"也。由 16 位元端的 Thunk 呼叫這些函式。
(如果尚未編譯)，如下所示編譯 Thunk 指令碼:
thunk -t thk 16to32.thk -o 16to32.asm
組合所產生的 Thunk 編譯器做為 32 位元物件模組的組件語言檔案。下面這一行顯示一個範例：
ml /DIS_32 /c /W3 /nologo /coff /Fo thk32.obj 16to32.asm
連結此物件模組做為 32 位元 DLL 的一部分。
連結 thunk32.lib 為 32 位元 DLL 的一部分。這是提供包含 Thunk 編譯器所建立的程式碼使用在 32 位元 thunking API 的參考 Win32 SDK 中的 32 位元匯入程式庫。

回此頁最上方

?考

如需有關如何偵錯平面 Thunk，請參閱下列文章「 Microsoft 知識庫」中的資訊：

133722? (http://support.microsoft.com/kb/133722/EN-US/ ) 如何偵錯平面 Thunk

回此頁最上方

這篇文章中的資訊適用於:

Microsoft Win32 Application Programming Interface?應用於:

Microsoft Windows 95
Microsoft Windows 98 Standard Edition
Microsoft Windows Millennium Edition

回此頁最上方

kbmt kbapi kbkernbase kbnetwork kbthunks KB154093 KbMtzh

回此頁最上方

機器翻譯

重要：本文是以 Microsoft 機器翻譯軟體翻譯而成，而非使用人工翻譯而成。Microsoft 同時提供使用者人工翻譯及機器翻譯兩個版本的文章，讓使用者可以依其使用語言使用知識庫中的所有文章。但是，機器翻譯的文章可能不盡完美。這些文章中也可能出現拼字、語意或文法上的錯誤，就像外國人在使用本國語言時可能發生的錯誤。Microsoft 不為內容的翻譯錯誤或客戶對該內容的使用所產生的任何錯誤或損害負責。Microsoft也同時將不斷地就機器翻譯軟體進行更新。

按一下這裡查看此文章的英文版本：154093? (http://support.microsoft.com/kb/154093/en-us/ )

回此頁最上方

Microsoft及(或)其供應商不就任何在本伺服器上發表的文字資料及其相關圖表資訊的恰當性作任何承諾。所有文字資料及其相關圖表均以「現狀」供應，不負任何擔保責任。Microsoft及(或)其供應商謹此聲明，不負任何對與此資訊有關之擔保責任，包括關於適售性、適用於某一特定用途、權利或不侵權的明示或默示擔保責任。Microsoft及(或)其供應商無論如何不對因或與使用本伺服器上資訊或與資訊的實行有關而引起的契約、過失或其他侵權行為之訴訟中的特別的、間接的、衍生性的損害或任何因使用而喪失所導致的之損害、資料或利潤負任何責任。

依現狀不再更新的知識庫內容免責聲明

本文旨在說明 Microsoft 不再提供支援的產品。因此，本文係依「現狀」提供，不會再更新。

回此頁最上方

This site in other countries/regions:

如何從 Windows 95、 Windows 98 或 Windows 千禧版下 16 位元程式碼呼叫 32 位元的程式碼

在此頁中

結論

其他相關資訊

建置平面 Thunk 所需的工具

正在建立 Thunk 指令碼

使用 Thunk 編譯器

建置 16 位元 DLL

建置 32 位元 DLL

?考

這篇文章中的資訊適用於:

關鍵字：?

其他支援網站

社群

文章翻譯