HOW TO：使用 C++ Interop 封送處理回呼和委派
更新：2007 年 11 月
這個主題示範如何使用 Visual C++，在 Managed 程式碼和 Unmanaged 程式碼之間封送處理 (Marshalling) 回呼 (Callback) 和委派 (Delegate) (Managed 版本的回呼)。
在下列範例中，程式碼會使用 managed, unmanaged #pragma 指示詞，在相同的檔案中實作 Managed 和 Unmanaged 函式，這些函式也可以在不同的檔案中定義。只包含 Unmanaged 函式的檔案，不需要以 /clr (Common Language Runtime 編譯) 編譯。
範例
下列範例會說明如何設定 Unmanaged API 以觸發 (Trigger) Managed 委派。這裡會建立 Managed 委派，並使用其中一個 Interop 方法 (GetFunctionPointerForDelegate) 來擷取委派的基礎進入點。接下來，這個位址會被傳遞至 Unmanaged 函式，該函式呼叫此位址時，並不知道它被實作成 Managed 函式。
請注意，您可以 (但非必要) 使用 pin_ptr Pin 此委派，以防止它遭到記憶體回收行程重新配置 (Re-locate) 或處置 (Dispose)。雖然必須防止提前進行記憶體回收，但是 Pin 會提供過多的保護，因為它雖然防止回收，但也阻礙了重新配置 (Relocation)。
如果委派被記憶體回收重新配置，將不會影響基礎 Managed 回呼，因此會使用 Alloc 在委派中加入參考，可讓委派重新配置而不致於遭到處置。使用 GCHandle (而非 pin_ptr) 可以降低 Managed 堆積 (Heap) 被分割的機會。
// MarshalDelegate1.cpp
// compile with: /clr
#include <iostream>
using namespace System;
using namespace System::Runtime::InteropServices;
#pragma unmanaged
// Declare an unmanaged function type that takes two int arguments
// Note the use of __stdcall for compatibility with managed code
typedef int (__stdcall *ANSWERCB)(int, int);
int TakesCallback(ANSWERCB fp, int n, int m) {
printf_s("[unmanaged] got callback address, calling it...\n");
return fp(n, m);
}
#pragma managed
public delegate int GetTheAnswerDelegate(int, int);
int GetNumber(int n, int m) {
Console::WriteLine("[managed] callback!");
return n + m;
}
int main() {
GetTheAnswerDelegate^ fp = gcnew GetTheAnswerDelegate(GetNumber);
GCHandle gch = GCHandle::Alloc(fp);
IntPtr ip = Marshal::GetFunctionPointerForDelegate(fp);
ANSWERCB cb = static_cast<ANSWERCB>(ip.ToPointer());
Console::WriteLine("[managed] sending delegate as callback...");
// force garbage collection cycle to prove
// that the delegate doesn't get disposed
GC::Collect();
int answer = TakesCallback(cb, 243, 257);
// release reference to delegate
gch.Free();
}
下列範例與上一個範例類似，只是在這種情況中，提供的函式指標是由 Unmanaged API 儲存，所以可以隨時叫用 (Invoke)，但記憶體回收必須停用一段時間。因此，下列範例會使用 GCHandle 的全域執行個體，在不考慮函式範圍的情況下，防止委派被重新配置。如第一個範例所述，在這些範例中不需要使用 pin_ptr，但在此情況中這個準則並不適用，因為 pin_ptr 的範圍被限制在單一函式之內。
// MarshalDelegate2.cpp
// compile with: /clr
#include <iostream>
using namespace System;
using namespace System::Runtime::InteropServices;
#pragma unmanaged
// Declare an unmanaged function type that takes two int arguments
// Note the use of __stdcall for compatibility with managed code
typedef int (__stdcall *ANSWERCB)(int, int);
static ANSWERCB cb;
int TakesCallback(ANSWERCB fp, int n, int m) {
cb = fp;
if (cb) {
printf_s("[unmanaged] got callback address (%d), calling it...\n", cb);
return cb(n, m);
}
printf_s("[unmanaged] unregistering callback");
return 0;
}
#pragma managed
public delegate int GetTheAnswerDelegate(int, int);
int GetNumber(int n, int m) {
Console::WriteLine("[managed] callback!");
static int x = 0;
++x;
return n + m + x;
}
static GCHandle gch;
int main() {
GetTheAnswerDelegate^ fp = gcnew GetTheAnswerDelegate(GetNumber);
gch = GCHandle::Alloc(fp);
IntPtr ip = Marshal::GetFunctionPointerForDelegate(fp);
ANSWERCB cb = static_cast<ANSWERCB>(ip.ToPointer());
Console::WriteLine("[managed] sending delegate as callback...");
int answer = TakesCallback(cb, 243, 257);
// possibly much later (in another function)...
Console::WriteLine("[managed] releasing callback mechanisms...");
TakesCallback(0, 243, 257);
gch.Free();
}