GNU-EFI：如何正确实现回调（调用约定不兼容问题）

问题根源 #

UEFI固件调用自定义回调函数时遵循特定的调用约定，而GCC默认的调用约定与之不匹配，导致栈帧错位，Context参数被破坏。uefi_call_wrapper仅解决我们调用UEFI函数的约定兼容问题，反过来固件调用我们的函数时，需要我们的函数符合UEFI要求的调用约定。

可行解决方案 #

1. 用EFIAPI宏声明回调函数 #

GNU-EFI在efi.h中定义了EFIAPI宏，用于指定UEFI标准的调用约定。回调函数必须通过该宏声明，确保与固件的调用逻辑匹配。

示例代码：

// 正确的回调函数定义
EFIAPI void MyEventCallback(
    EFI_EVENT TriggeredEvent,
    VOID *Context
) {
    // Context参数可正常访问
    MyCustomData *data = (MyCustomData*)Context;
    // 执行回调逻辑
}

2. 保证Context参数的内存有效性 #

• 禁止传递栈上的局部变量作为Context：回调触发时，原函数的栈帧可能已销毁，导致指针失效。必须使用全局变量、静态变量，或通过BS->AllocatePool分配的堆内存。
• 堆内存示例：

EFI_STATUS status;
MyCustomData *callbackCtx;

// 分配可持久化的内存
status = BS->AllocatePool(
    EfiLoaderData,
    sizeof(MyCustomData),
    (VOID**)&callbackCtx
);
if (EFI_ERROR(status)) {
    // 处理内存分配失败
}

// 初始化上下文数据
callbackCtx->someField = 0x1234;

// 注册回调时传递有效Context
status = BS->CreateEvent(
    EVT_NOTIFY_SIGNAL,
    TPL_CALLBACK,
    MyEventCallback,
    callbackCtx,
    &g_MyEventHandle
);

3. 校验TPL参数的正确性 #

创建事件时指定的任务优先级级别（TPL）必须与回调函数的执行场景匹配，过高的TPL可能引发内存访问异常，间接导致Context参数无效。绝大多数回调场景使用TPL_CALLBACK即可。

额外提示 #

• 确保编译时使用GNU-EFI的标准编译选项，比如-ffreestanding -fshort-wchar -mno-red-zone，避免编译选项导致的调用约定或内存布局问题。
• 所有被UEFI固件直接调用的自定义函数（不仅限于回调），都需要用EFIAPI宏声明。

内容的提问来源于stack exchange，提问作者pumpe_duese