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硬盤的分區表