UEFI Application 如何调用 Protocol（一）

/ 57 次浏览/ 番摊机器人

UEFI Application如何调用Protocol（一）

在UEFI系统架构中，Protocol是实现组件间通信的核心机制，它为不同模块提供了标准化的交互接口。对于UEFI Application开发者来说，掌握Protocol的调用方法是解锁系统底层功能的关键。本文将从基础概念入手，详细介绍UEFI Application调用Protocol的完整流程。

一、Protocol核心概念解析

Protocol本质上是一种接口规范，由全局唯一标识符（GUID）、接口结构体和服务函数三部分组成。每个Protocol都有一个专属GUID，确保在系统中的唯一性；接口结构体包含函数指针和相关数据定义；服务函数则是实际实现功能的代码逻辑。

与传统函数调用不同，Protocol采用了类似面向对象的设计思想：用结构体模拟类，用函数指针模拟成员函数，并且每个服务函数的第一个参数必须是指向Protocol实例的指针（模拟this指针）。这种设计使得Protocol具有良好的扩展性和兼容性，不同厂商的硬件和软件可以通过统一接口实现交互。

二、调用Protocol的前置准备

在开始编写调用代码前，需要完成两项关键准备工作：

  1. 头文件引用：必须包含对应Protocol的头文件，例如调用块设备Protocol需要引入Protocol/BlockIo.h，调用串口Protocol需要引入Protocol/SerialIo.h。这些头文件定义了Protocol的GUID、结构体和函数指针类型。

  2. GUID声明：每个Protocol都有一个全局唯一的GUID，需要在代码中声明对应的外部变量。例如块设备Protocol的GUID声明为extern EFI_GUID gEfiBlockIoProtocolGuid;。

此外，还需要在工程配置文件（.inf）中添加相关Protocol所在的包依赖，确保编译时能正确找到头文件和库文件。

三、调用Protocol的核心流程

3.1 定位Protocol实例

UEFI提供了多种定位Protocol的方法，其中最常用的是LocateProtocol和OpenProtocol函数：

  • LocateProtocol：用于查找系统中已安装的指定Protocol实例，适合获取全局唯一的Protocol（如系统服务类Protocol）。函数原型为：

    typedef EFI_STATUS (EFIAPI *EFI_LOCATE_PROTOCOL)(
     IN EFI_GUID *Protocol,
     IN VOID *Registration OPTIONAL,
     OUT VOID **Interface
    );

  • OpenProtocol：用于从指定设备句柄中打开Protocol，适合与特定硬件设备交互。函数原型为：

    typedef EFI_STATUS (EFIAPI *EFI_OPEN_PROTOCOL)(
     IN EFI_HANDLE Handle,
     IN EFI_GUID *Protocol,
     OUT VOID **Interface OPTIONAL,
     IN EFI_HANDLE AgentHandle,
     IN EFI_HANDLE ControllerHandle,
     IN UINT32 Attributes
    );

3.2 调用Protocol服务函数

成功获取Protocol实例后，就可以通过结构体中的函数指针调用具体服务。以块设备Protocol的读操作为例：

EFI_BLOCK_IO_PROTOCOL *BlockIo;
EFI_STATUS Status;
UINT8 Buffer;

// 定位块设备Protocol
Status = gBS->LocateProtocol(&gEfiBlockIoProtocolGuid, NULL, (VOID **)&BlockIo);
if (EFI_ERROR(Status)) {
 Print(L"Failed to locate BlockIo Protocol: %r\n", Status);
 return Status;
}

// 读取第一个扇区数据
Status = BlockIo->ReadBlocks(BlockIo, BlockIo->Media->MediaId, 0, sizeof(Buffer), Buffer);
if (EFI_ERROR(Status)) {
 Print(L"Failed to read blocks: %r\n", Status);
 return Status;
}

3.3 关闭Protocol（可选）

对于使用OpenProtocol打开的Protocol，在使用完成后应调用CloseProtocol关闭，以释放相关资源：

gBS->CloseProtocol(Handle, &gEfiBlockIoProtocolGuid, AgentHandle, ControllerHandle);

四、常见问题与调试技巧

在调用Protocol过程中，常见问题包括找不到Protocol实例、参数错误、权限不足等。可以通过以下方法进行调试：

  1. 使用DEBUG宏输出调试信息：在关键步骤添加DEBUG((EFI_D_ERROR, "Message: %r\n", Status));，查看函数返回状态。

  2. 检查GUID是否正确：GUID的任何微小错误都会导致无法找到Protocol，建议直接使用头文件中定义的GUID常量。

  3. 验证Protocol是否已安装：可以使用UEFI Shell中的drivers和protocols命令查看系统中已安装的驱动和Protocol。

通过本文的介绍，相信读者已经掌握了UEFI Application调用Protocol的基本方法。在实际开发中，不同Protocol的具体调用细节可能会有所差异，但核心流程是一致的。下一篇文章将深入探讨如何开发自定义Protocol并在Application中调用。 


<< 上一篇

LLM 后训练 / Agent 相关小规模开源项目汇报总结

下一篇 >>

UEFI Application如何调用Protocol（二）

相关文章