C# UnmanagedCallersOnly属性方法 C#如何从本地代码回调托管方法

来源:这里教程网 时间:2026-02-21 17:41:00 作者:

UnmanagedCallersOnly 方法不能被本地代码直接回调

这是最常被误解的一点:

UnmanagedCallersOnly
属性只控制「托管方法能否被非托管代码调用」,但它**不提供回调机制**。它只是让一个
static
方法具备 C ABI 兼容签名(如
__cdecl
),并禁用 JIT 编译器的某些优化(比如栈探针、GC 检查),从而能被
GetProcAddress
或函数指针安全调用。但它本身不注册、不导出、不维护任何跨语言回调通道。

本地代码回调托管方法必须靠委托 + Marshal.GetFunctionPointerForDelegate

真正可行的路径是:在托管侧定义一个匹配本地函数签名的委托类型,实例化委托,再用

Marshal.GetFunctionPointerForDelegate
转成原生函数指针,把该指针传给本地库(比如通过初始化 API 或回调注册函数)。关键点:

委托类型必须用
UnmanagedFunctionPointer
显式指定调用约定(通常是
CallingConvention.Cdecl
StdCall
),否则指针调用时会栈失衡
委托实例必须长期存活(不能被 GC 回收),需保存强引用(如 static 字段或
GCHandle.Alloc
若回调可能从非主线程进入,方法体内需注意线程上下文(如 UI 线程需调度,但
UnmanagedCallersOnly
方法默认无上下文)
GetFunctionPointerForDelegate
返回的指针在 .NET 5+ 中是稳定的,但仅限于 delegate 实例生命周期内有效

为什么不用 UnmanagedCallersOnly 做回调入口?

因为

UnmanagedCallersOnly
方法没有托管对象实例上下文,无法捕获闭包、无法访问
this
、无法调用非静态成员——它本质上就是个裸函数。而绝大多数回调场景需要携带状态(比如传入的
void*
用户数据、事件处理器对象等)。常见错误现象:

试图把
UnmanagedCallersOnly
方法地址硬编码传给本地库,结果调用时崩溃(
AccessViolationException
或静默失败)
typeof(MyClass).GetMethod("Callback").MethodHandle.GetFunctionPointer()
取地址 —— 这返回的是内部 JIT 地址,不可用于跨语言调用
委托未持久引用,GC 后指针悬空,本地代码一回调就触发 AV

一个最小可运行示例(C# → C DLL 回调)

假设本地 DLL 提供:

typedef void (*callback_t)(int code, const char* msg);
void set_callback(callback_t cb);

// 托管侧
[UnmanagedFunctionPointer(CallingConvention.Cdecl)]
delegate void LogCallback(int code, IntPtr msg);
<p>static LogCallback _callback = (code, msg) =>
{
var str = Marshal.PtrToStringUTF8(msg);
Console.WriteLine($"[{code}] {str}");
};</p><p>// 必须保持引用!
static IntPtr _callbackPtr;</p><p>static void Init()
{
_callbackPtr = Marshal.GetFunctionPointerForDelegate(_callback);
set_callback((callback_t)_callbackPtr); // P/Invoke 导入的 set_callback
}

漏掉

_callback
的 static 引用,或没调用
Init()
,回调就会失效。这也是最容易被忽略的环节:不是写对了就能用,而是得管住生命周期。

相关推荐