为什么 C# 里 delegate*
不是常规 delegate 的替代品
delegate*是 C# 9 引入的非托管函数指针语法,本质是
void*级别的裸地址,不带任何 CLR 运行时元数据或闭包支持。它只在
unsafe上下文中有效,且调用目标必须是
static、
unmanaged(无托管引用)、无泛型、无异常处理的纯方法。这意味着你不能把它指向一个捕获了局部变量的 lambda,也不能指向实例方法——哪怕加
static修饰符也不行,因为实例方法隐含
this参数,破坏调用约定。
常见错误现象:
CS8802: A function pointer cannot point to a method that contains a 'this' parameter或
CS8805: Method 'X' is not unmanaged。根本原因不是写法错,而是方法签名不符合底层 ABI 要求。 必须用
unmanaged修饰符声明方法(C# 11+),或确保方法体中不出现任何托管类型(如
string、
object、
List<t></t>) 参数和返回值只能是基本类型(
int、
float、
IntPtr)、
void,或
unmanaged struct不能有
try/catch、
using、
await,也不能调用任何可能触发 GC 的 API
如何正确定义并调用 delegate*
定义格式固定:
delegate* unmanaged[Cdecl]。方括号里的调用约定可选
Cdecl、
Stdcall、
Fastcall(x64 下后两者被忽略),不写则默认为
Cdecl。注意这不是泛型类型, 里填的是真实类型,不是占位符。
实操示例:
unsafe
{
// 正确:静态、unmanaged、无副作用的方法
static int Add(int a, int b) => a + b;
<pre class="brush:php;toolbar:false;">// 获取函数指针(必须显式 cast)
delegate* unmanaged[int, int, int] ptr = &Add;
// 调用
int result = ptr(3, 4); // result == 7}
关键点:
&Add只对静态方法有效;实例方法需先提取为委托再转指针(但会失去性能优势) 不能直接写
ptr(3, 4)在 safe 上下文——必须包裹在
unsafe块中 如果方法签名含指针(如
int* p),调用时传参也必须是兼容指针,编译器不会自动转换
在 P/Invoke 回调场景中用 delegate*
替代 Marshal.GetFunctionPointerForDelegate
传统 P/Invoke 回调常通过
delegate+
Marshal.GetFunctionPointerForDelegate实现,但该方式需分配托管委托对象、注册 GC 句柄、生成 thunk,开销大且易因提前回收导致崩溃。而
delegate*是纯地址,零分配、零 GC 压力,适合高频回调(如音频处理、游戏帧循环、硬件中断响应)。
使用前提:
原生库明确要求传入 C-style 函数指针(如typedef void (*callback_t)(int, float)) 你的回调逻辑足够简单,能写成
unmanaged方法 你控制调用生命周期——
delegate*不做生存期管理,若原生代码长期持有指针而托管方法被 JIT 优化掉或 DLL 卸载,就会 crash
典型模式:
[DllImport("native.dll")]
static extern void RegisterCallback(delegate* unmanaged[int, void] cb);
<p>unsafe
{
static void OnEvent(int code) { /<em> ... </em>/ }
RegisterCallback(&OnEvent);
}</p>注意:这里没用
fixed或
GCHandle,因为
&OnEvent指向的是 JIT 编译后的固定代码地址,只要程序域不卸载,它就一直有效。
性能差异在哪?什么情况下反而更慢
纯粹调用开销上,
delegate*比
delegate快 3–5 倍(实测 x64,无内联时),主要省去了委托对象虚表查表、多层间接跳转、空引用检查。但真实收益取决于上下文: 如果回调体本身要分配内存、访问集合、调用 LINQ,那函数指针省下的几纳秒毫无意义 若需从回调中反向调用托管代码(比如通知 UI 线程),必须通过额外机制(如
QueueUserWorkItem、
Task.Run)桥接,此时安全边界成本远超指针调用节省 Debug 模式下 JIT 可能不内联
unmanaged方法,导致实际性能不如 Release 模式下的普通 delegate
最容易被忽略的一点:
delegate*完全绕过 .NET 的类型安全和异常传播机制。一旦被调用的方法抛出异常(哪怕只是访问了 null 指针),会直接终止进程,没有任何
catch机会。这不是 bug,是设计使然——你要的本来就是 C 级别控制权。
