以视频解码服务为例,学习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的定义为空,仅有提示作用为无其他实际意义。