笔记——Protocol（2）通过服务型驱动学习Protocol

以视频解码服务为例，学习Protocol

Protocol服务接口

视频解码Protocol需要提供相应的服务，比如OpenVideo用来打开视频，QueryFrame用于取得一帧，CloseFrame用于关闭视频，等等。

根据UEFI命名规范，可以将这个视频解码Protocol命名为EFI_FFDECODER_PROTOCOL，Protocol结构体名字通常是Protocol的名字再在前面加上“_”，因此视频解码Protocol结构体的名字为_EFI_FFDECODER_PROTOCOL。

EFI_FFDECODER_PROTOCOL是结构体_EFI_FFDECODER_PROTOCOL的类型定义，还可以为EFI_FFDECODER_PROTOCOL定义一个别名EFI_FFDECODER。

在Protocol中还有一个域Revision，用于表示Protocol的版本号。

每个Protocol必须有一个唯一的GUID，即不能与其他Protocol重复。按照微软公司的定义，GUID可以看作一个16字节的数字，是4B-2B-2B-8B的结构体。

通常 GUID的名字是Protocol名字加“_GUID”后缀。视频解码Protocol的GUID名字为EFI_FFDECODER_PROTOCOL_GUID。这个EFI_FFDECODER_PROTOCOL_GUID是宏，通常设计Protocol时还需要提供一个同名的全局变量，命名规范是以g开头，变量中单词首字符大写，变量中没有“_”。所以视频解码Protocol的GUID变量为gEfiFFDecoderProtocolGUID。

Protocol的成员函数必须遵循一下两个准则：

• 函数使用EFIAPI调用约定，函数类型必须加EFIAPI修饰。
• 函数的第一个参数必须是指向Protocol自身的This指针。

另外两个建议的准则：

• 函数返回值类型为EFI_STATUS，用于返回错误代码。
• 在用于输入的参数前面加宏IN，用于提示Protocol的使用者该参数为输入参数；在用于输出的参数前加OUT，用于提示Protocol的使用者该参数为输出函数。IN和OUT的定义为空，仅有提示作用为无其他实际意义。