string

什么是protocol
从字面意思上看，protocol是server和client之间的一种约定，双方根据这种约定互通信息。这里的server和client是一种广义的称呼，提供服务的称为server，使用服务的称为client。 TCP是一种protocol， client(应用程序)通过一组函数来压包和解包，压包和解包是server提供的服务。COM也是一种protocol，client通过CoCreateInstance(...)和GUID获得指向COM对象的指针，然后使用该指针获得COM对象提供的服务， GUID标示了这个COM对象。现在我们对protocol有了概念上的理解，那么具体到UEFI里，protocol是什么样子呢？ 如何标示一个protocol？如何得到protocol对应的对象？...容我慢慢道来.
在讲protocol什么样子之前，还要插几句C与C++的区别。我们知道UEFI是用C来开发的，C是面向过程的一种语言。而管理和使用UEFI众多的protocol完全使用面向过程的思想会使程序变得复杂。protocol作为一种对象来设计管理会比较直观。因而UEFI中的Protocol引入了面向对象的思想，用struct来模拟class, Protocol用struct来实现，用函数指针(Protocol的成员变量)模拟成员函数，此种函数的第一参数必须是指向Protocol的指针，用来模拟this指针。
Protocol的摸样
以EFI_DISKIO_PROTOCOL 来看看Protocol的样子。 

MdePkg/Include/Protocol/BlockIo.h

:220
来看成员函数的声明EFI_BLOCK_READ具体用法我们先不看，我们来看它的第一个参数，指向EFI_BLOCK_IO_PROTOCOL  对象自己的this指针，这是成员函数区别于一般函数的重要特征。

如何使用Protocol       
使用Protocol之前，我们要弄清楚Protocol位于什么地方。首先我们要来认识一下EFI_HANDLE，
EFI_HANDLE是指向某种对象的指针，UEFI用它来表示某个对象。 UEFI扫描总线后，会为每个设备建立一个Controller对象，用于控制设备，所有该设备的驱动以protocol的形式安装到这个controller中，这个Controller就是一个EFI_HANDLE对象。 当我们将一个.efi文件加载到内存中，UEFI也会为该文件建立一个Image对象（此Image非图像的意识), 这个Image对象也是一个EFI_HANDLE对象。 在UEFI内部，EFI_HANDLE被理解为IHANDLE
每个IHANDLE中都有一个Protocols链表，存放属于自己的protocol。所有的IHANDLE通过AllHandles链接起来。
要使用Protocol，首先要找到protocol对象，可以通过BootServices的OpenProtocol(...), HandleProtocl(...), LocateProtocol(...)获得。
Handle是Protocol的提供者，如果Handle的Protocols链表中有该Potocol，Protocol对象的指针写到*Interface，并返回EFI_SUCCESS；否则 返回EFI_UNSUPPORTED 。
如果在驱动中调用OpenProtocol()， AgentHandle是拥有该EFI_DRIVER_BINDING_PROTOCOL对象的Handle；ControllerHandle是拥有该驱动的Controller。
如果调用OpenProtocol的是应用程序，那么AgentHandle是该应用对应的Handle，也就main函数的第一个参数。 ControllerHandle此时可以忽略。

Attributes可以取以下5种值。

HandleProtocol是OpenProtocol的简化版，因为大部分情况下我们都不需要关心AgentHandle，ControllerHandle和Attributes。

EFI_STATUS
EFIAPI
CoreHandleProtocol (
  IN EFI_HANDLE       UserHandle,
  IN EFI_GUID         *Protocol,
  OUT VOID            **Interface
  )
{
  return CoreOpenProtocol (
          UserHandle,
          Protocol,
          Interface,
          gDxeCoreImageHandle,
          NULL,
          EFI_OPEN_PROTOCOL_BY_HANDLE_PROTOCOL
          );
}

LocateProtocol(...)是从内核中找出指定Protocol的第一个实例。
UEFI内核中某个Protocol的实例可能不止一个，例如每个硬盘及每个分区都有一个EFI_DISK_IO_PROTOCOL实例。LocateProtocol顺序搜索HANDLE链表，返回找到的第一个该Protocol的实例。
我们可以用BootServices提供的其它函数处理HANDLE和Protocol。可以获得所有支持指定Protocol的HANDLE，SearchType 有三种：AllHandles(查找所有HANDLE), ByRegisterNotify, ByProtocol（查找支持指定Protocol的HANDLE）。NoHandles是找到的HANDLE的数量， Buffer数组由UEFI复杂分配，由用户负责释放。
与LocateHandleBuffer相似，只是用户负责分配和释放Buffer数组。
获得指定Handle所支持的所有Protocol， UEFI负责分配内存给ProtocolBuffer，用户负责释放该内存。

typedef
EFI_STATUS
(EFIAPI *EFI_OPEN_PROTOCOL_INFORMATION) (
IN EFI_HANDLE Handle,
IN EFI_GUID    *Protocol,
OUT EFI_OPEN_PROTOCOL_INFORMATION_ENTRY **EntryBuffer,
OUT UINTN     *EntryCount
);

typedef struct {

  EFI_HANDLE  AgentHandle;

  EFI_HANDLE  ControllerHandle;

  UINT32        Attributes;

  UINT32        OpenCount;

} EFI_OPEN_PROTOCOL_INFORMATION_ENTRY;

OpenProtocolInformation()获得指定Handle中指定Protocol的打开信息。
SPEC2.3.1第165页有很好的例子演示了怎么打开一个Protocol， 
打开Protocol之后就可以使用了，最后要通过CloseProtocol关闭打开的Protocol。
通过HandleProtocol和LocateProtocol打开的Protocol因为没有指定AgentHandle，所以无法关闭。如果一定要去关闭它，要调用OpenProtocolInformation()获得AgentHandle和ControllerHandle，然后关闭它。
下面看一个完整的例子，用EFI_DISK_IO_PROTOCOL读取GPT硬盘的分区表