【UEFI实战】HII之vfr文件

我会带着你远行 2023-10-01 17:31 4阅读 0赞

## vfr文件 ##

HII的实现涉及到多种不同类型的文件，vfr文件是其中最重要的一种，它构成了界面的结构样式。本文主要参考自《edk-ii-vfr-specification.pdf》，后面简称为参考文档。

UEFI代码操作UI界面，并不是直接使用vfr文件，而是称为**IFR**（Internal Forms Representation）的二进制，vfr文件只是IFR的字符串表示，方便通过可识别的字符串作为代码来编写界面，然后通过VFR编译器编译出IFR二进制，最终给UEFI代码使用。

以前面出现过的Front Page为例，图中界面的结构依赖于vfr文件MdeModulePkg\\Application\\UiApp\\FrontPageVfr.Vfr，它构建了Front Page页面的骨架，该文件内容如下：

#define FORMSET_GUID  { 0x9e0c30bc, 0x3f06, 0x4ba6, 0x82, 0x88, 0x9, 0x17, 0x9b, 0x85, 0x5d, 0xbe }
    
    #define FRONT_PAGE_FORM_ID             0x1000
    
    #define LABEL_FRANTPAGE_INFORMATION    0x1000
    #define LABEL_END                      0xffff
    
    formset
      guid     = FORMSET_GUID,
      title    = STRING_TOKEN(STR_FRONT_PAGE_TITLE),
      help     = STRING_TOKEN(STR_EMPTY_STRING ),
      classguid = FORMSET_GUID,
    
      form formid = FRONT_PAGE_FORM_ID,
           title  = STRING_TOKEN(STR_FRONT_PAGE_TITLE);
    
        banner
          title = STRING_TOKEN(STR_FRONT_PAGE_COMPUTER_MODEL),
          line  1,
          align left;
    
        banner
          title = STRING_TOKEN(STR_FRONT_PAGE_CPU_MODEL),
          line  2,
          align left;
    
        banner
          title = STRING_TOKEN(STR_FRONT_PAGE_CPU_SPEED),
          line  2,
          align right;
    
        banner
          title = STRING_TOKEN(STR_FRONT_PAGE_BIOS_VERSION),
          line  3,
          align left;
    
        banner
          title = STRING_TOKEN(STR_FRONT_PAGE_MEMORY_SIZE),
          line  3,
          align right;
    
        banner
          title = STRING_TOKEN(STR_CUSTOMIZE_BANNER_LINE4_LEFT),
          line  4,
          align left;
    
        banner
          title = STRING_TOKEN(STR_CUSTOMIZE_BANNER_LINE4_RIGHT),
          line  4,
          align right;
    
        banner
          title = STRING_TOKEN(STR_CUSTOMIZE_BANNER_LINE5_LEFT),
          line  5,
          align left;
    
        banner
          title = STRING_TOKEN(STR_CUSTOMIZE_BANNER_LINE5_RIGHT),
          line  5,
          align right;
    
        label LABEL_FRANTPAGE_INFORMATION;
        //
        // This is where we will dynamically add a Action type op-code to show
        // the platform information.
        //
        label LABEL_END;
    
      endform;

它构成的结构基本样式如下：

STR_FRONT_PAGE_COMPUTER_MODEL
    STR_FRONT_PAGE_CPU_MODEL								STR_FRONT_PAGE_CPU_SPEED
    STR_FRONT_PAGE_BIOS_VERSION								STR_FRONT_PAGE_MEMORY_SIZE
    STR_CUSTOMIZE_BANNER_LINE4_LEFT							STR_CUSTOMIZE_BANNER_LINE4_RIGHT
    STR_CUSTOMIZE_BANNER_LINE5_LEFT							STR_CUSTOMIZE_BANNER_LINE5_RIGHT
    LABEL_FRANTPAGE_INFORMATION
    LABEL_END

对应到Front Page界面中（第四、五行没有使用）：

![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_18_color_FFFFFF_t_70_g_se_x_16_pic_center]

红色字体部分是vfr文件中定义的标记，而显示的字符串有一部分是在uni文件中定义的，而红框部分是通过代码实现的，所以vfr文件构成了界面的静态框架，而代码又可以通过vfr文件中定义的标记来动态修改。

vfr文件通过特定的VFR编译器编译，最终得到的是中间文件。该中间文件是一个c文件（FrontPageVfr.c）或者hpk文件，里面就是一个变量用来表示VFR资源：

unsigned char FrontPageVfrBin[] = {
        
      // ARRAY LENGTH，0x143加上下述的头部长度，就是0x147
      0x47,  0x01,  0x00,  0x00,  
    
      // PACKAGE HEADER，对应的是EFI_HII_FORM_PACKAGE_HDR，0x13F加上下述的头部长度，就是0x143，占据3个字节；第4个字节0x02表示HII类型Form
      0x43,  0x01,  0x00,  0x02,  
    
      // PACKAGE DATA，319个字节，十六进制就是0x13F，注释已经加上
    
      // 第1个操作码，对应结构体EFI_IFR_FORM_SET
      0x0E,  // EFI_IFR_FORM_SET_OP，它的值就是0xE
      0xA7,  // 前面7位表示长度，即0x27=39个字节，总长度到第二个FORMSET_GUID为止刚好39个字节；第8位表示的是scope，该位为1则表示开始一个新的scope
      // Guid: FORMSET_GUID
      0xBC,  0x30,  0x0C,  0x9E,  0x06,  0x3F,  0xA6,  0x4B,  0x82,  0x88,  0x09,  0x17,  0x9B,  0x85,  0x5D,  0xBE,  
      0x02,  0x00,  // FormSetTitle：字符串Token，在AutoGen中定义，对应的是STR_FRONT_PAGE_TITLE，值就是0x0002
      0x0C,  0x00,  // Help：字符串Token，在AutoGen中定义，对应的是STR_EMPTY_STRING，值就是0x000C
      0x01,	// Flags:
      // ClassGuid: FORMSET_GUID
      0xBC,  0x30,  0x0C,  0x9E,  0x06,  0x3F,  0xA6,  0x4B,  0x82,  0x88,  0x09,  0x17,  0x9B,  0x85,  0x5D,  0xBE,
    
      // 第2个操作码，对应结构体EFI_IFR_DEFAULTSTORE
      0x5C,  // 操作码EFI_IFR_DEFAULTSTORE_OP
      0x06,  // 长度6个字节
      0x00,  0x00,  // DefaultName：字符串Token，似乎并不存在
      0x00,  0x00,  // DefaultId：表示EFI_HII_DEFAULT_CLASS_STANDARD
    
      // 第3个操作码，对应结构体EFI_IFR_DEFAULTSTORE
      0x5C,  // 操作码EFI_IFR_DEFAULTSTORE_OP
      0x06,  // 长度6个字节
      0x00,  0x00,  // DefaultName：字符串Token，似乎并不存在
      0x01,  0x00,  // DefaultId：表示EFI_HII_DEFAULT_CLASS_MANUFACTURING
      // 前面两个操作码并没有在vfr文件中声明，但是却创建了。
    
      // 第4个操作码，对应结构体EFI_IFR_FORM
      0x01,  // 操作码示EFI_IFR_FORM_OP
      0x86,  // 长度6个字节，新建scope
      0x00,  0x10,  // FormId：对应FRONT_PAGE_FORM_ID
      0x02,  0x00,  // FormTitle：对应字符串Token，STR_FRONT_PAGE_TITLE
    
      // 第5个操作码，对应结构体EFI_IFR_GUID_BANNER
      0x5F,  // 操作码示EFI_IFR_GUID_OP
      0x18,  // 长度24个字节，其中16个是GUID
      // EFI_IFR_TIANO_GUID，表示GUIDed opcodes defined for EDKII implementation，定义在MdeModulePkg\Include\Guid\MdeModuleHii.h
      0x35,  0x17,  0x0B,  0x0F,  0xA0,  0x87,  0x93,  0x41,  0xB2,  0x66,  0x53,  0x8C,  0x38,  0xAF, 0x48,  0xCE,  
      0x01,  // ExtendOpCode，0x01表示EFI_IFR_EXTEND_OP_BANNER
      0x03,  0x00,  // Title，对应字符串Token，0x0003对应的是STR_FRONT_PAGE_COMPUTER_MODEL
      0x01,  0x00,  // LineNumber
      0x00,  // Alignment
        
      0x5F,  0x18,  0x35,  0x17,  0x0B,  0x0F,  0xA0,  0x87,  0x93,  0x41,  0xB2,  0x66,  0x53,  0x8C,  0x38,  0xAF,  
      0x48,  0xCE,  0x01,  0x04,  0x00,  0x02,  0x00,  0x00,  
        
      0x5F,  0x18,  0x35,  0x17,  0x0B,  0x0F,  0xA0,  0x87,  0x93,  0x41,  0xB2,  0x66,  0x53,  0x8C,  0x38,  0xAF,  
      0x48,  0xCE,  0x01,  0x05,  0x00,  0x02,  0x00,  0x02,  
        
      0x5F,  0x18,  0x35,  0x17,  0x0B,  0x0F,  0xA0,  0x87,  0x93,  0x41,  0xB2,  0x66,  0x53,  0x8C,  0x38,  0xAF,  
      0x48,  0xCE,  0x01,  0x07,  0x00,  0x03,  0x00,  0x00,  
        
      0x5F,  0x18,  0x35,  0x17,  0x0B,  0x0F,  0xA0,  0x87,  0x93,  0x41,  0xB2,  0x66,  0x53,  0x8C,  0x38,  0xAF,  
      0x48,  0xCE,  0x01,  0x06,  0x00,  0x03,  0x00,  0x02,  
        
      0x5F,  0x18,  0x35,  0x17,  0x0B,  0x0F,  0xA0,  0x87,  0x93,  0x41,  0xB2,  0x66,  0x53,  0x8C,  0x38,  0xAF,  
      0x48,  0xCE,  0x01,  0x0E,  0x00,  0x04,  0x00,  0x00,  
        
      0x5F,  0x18,  0x35,  0x17,  0x0B,  0x0F,  0xA0,  0x87,  0x93,  0x41,  0xB2,  0x66,  0x53,  0x8C,  0x38,  0xAF,  
      0x48,  0xCE,  0x01,  0x0F,  0x00,  0x04,  0x00,  0x02,  
        
      0x5F,  0x18,  0x35,  0x17,  0x0B,  0x0F,  0xA0,  0x87,  0x93,  0x41,  0xB2,  0x66,  0x53,  0x8C,  0x38,  0xAF,  
      0x48,  0xCE,  0x01,  0x10,  0x00,  0x05,  0x00,  0x00,  
        
      0x5F,  0x18,  0x35,  0x17,  0x0B,  0x0F,  0xA0,  0x87,  0x93,  0x41,  0xB2,  0x66,  0x53,  0x8C,  0x38,  0xAF,  
      0x48,  0xCE,  0x01,  0x11,  0x00,  0x05,  0x00,  0x02,  
      
      // 第14个操作码，对应结构体EFI_IFR_GUID_LABEL
      0x5F,  // 操作码示EFI_IFR_GUID_OP
      0x15,  // 长度21个字节，其中16个是GUID
      // EFI_IFR_TIANO_GUID，表示GUIDed opcodes defined for EDKII implementation，定义在MdeModulePkg\Include\Guid\MdeModuleHii.h
      0x35,  0x17,  0x0B,  0x0F,  0xA0,  0x87,  0x93,  0x41,  0xB2,  0x66,  0x53,  0x8C,  0x38,  0xAF,  0x48,  0xCE,  
      0x00,  // ExtendOpCode，0x00表示EFI_IFR_EXTEND_OP_LABEL
      0x00,  0x10,  // Label Number.
        
      0x5F,  0x15,  0x35,  0x17,  0x0B,  0x0F,  0xA0,  0x87,  0x93,  0x41,  0xB2,  0x66,  0x53,  0x8C,  0x38,  0xAF,  
      0x48,  0xCE,  0x00,  0xFF,  0xFF,  
        
      0x29,  0x02,  
        
      0x29,  0x02
    };

这些数据就是IFR二进制，它们通过`HiiAddPackages()`安装：

//
      // Publish our HII data
      //
      gFrontPagePrivate.HiiHandle = HiiAddPackages (
                                      &mFrontPageGuid,
                                      gFrontPagePrivate.DriverHandle,
                                      FrontPageVfrBin,
                                      UiAppStrings,
                                      NULL
                                      );

这样就可以通过`gFrontPagePrivate.HiiHandle`来访问安装的资源了。

跟uni文件一样，vfr文件也有两种使用方式，一种是定义中间文件的变量，另一种是直接定义二进制。以上的代码使用的是中间文件的方式，除去前面的4个字节，剩余的部分对应到一个结构体：

///
    /// The header found at the start of each package.
    ///
    typedef struct {
        
      UINT32  Length:24;
      UINT32  Type:8;
      // UINT8  Data[...];
    } EFI_HII_PACKAGE_HEADER;
    ///
    /// The Form package is used to carry form-based encoding data.
    ///
    typedef struct _EFI_HII_FORM_PACKAGE_HDR {
        
      EFI_HII_PACKAGE_HEADER       Header;
      // EFI_IFR_OP_HEADER         OpCodeHeader;
      // More op-codes follow
    } EFI_HII_FORM_PACKAGE_HDR;

`EFI_HII_PACKAGE_HEADER`的`Type`有如下的类型，它表示的是所有HII的类型，比如结构、字体、字符串等：

//
    // Value of HII package type
    //
    #define EFI_HII_PACKAGE_TYPE_ALL             0x00
    #define EFI_HII_PACKAGE_TYPE_GUID            0x01
    #define EFI_HII_PACKAGE_FORMS                0x02
    #define EFI_HII_PACKAGE_STRINGS              0x04
    #define EFI_HII_PACKAGE_FONTS                0x05
    #define EFI_HII_PACKAGE_IMAGES               0x06
    #define EFI_HII_PACKAGE_SIMPLE_FONTS         0x07
    #define EFI_HII_PACKAGE_DEVICE_PATH          0x08
    #define EFI_HII_PACKAGE_KEYBOARD_LAYOUT      0x09
    #define EFI_HII_PACKAGE_ANIMATIONS           0x0A
    #define EFI_HII_PACKAGE_END                  0xDF
    #define EFI_HII_PACKAGE_TYPE_SYSTEM_BEGIN    0xE0
    #define EFI_HII_PACKAGE_TYPE_SYSTEM_END      0xFF

对于vfr文件描述的结构来说，其类型当然是`EFI_HII_PACKAGE_FORMS`，值是2。

头部之后的内容就是一个个的操作码，其结构体如下：

typedef struct _EFI_IFR_OP_HEADER {
        
      UINT8                    OpCode;
      UINT8                    Length:7;
      UINT8                    Scope:1;
    } EFI_IFR_OP_HEADER;

该结构体也是不定长的，之后跟有数据，根据不同的操作码，数据也不一样，如下图所示：

![在这里插入图片描述][ee12d9514b97495eb5d82bd40a1a7a18.png_pic_center]

操作码已经在IFR操作码列出；长度包含整个不定长结构体，即也包含头部的长度；`Scope`如果是1就表示开启了一个新的Scope，直到遇到`EFI_IFR_END_OP`为止。

## 语言基础 ##

`vfr`文件也使用EBNF来描述，这里就不再多介绍，只是简单说明基本语言基础。

*  通过`//`来注释；
 *  支持预定义指令：
    
     *  `#define`：跟c语言中的使用差不多，就是定义宏；
     *  `#include`：可以包含c语言头文件；
     *  `#pragma`：c语言头文件中会使用到，比如对于头文件中的结构体，可以设置其对齐方式。
 *  支持基本数据类型和HII特定的数据类型，也支持结构体：
    
     *  `UINT8`、`UINT16`、`UINT32`、`UINT64`、`BOOLEAN`等；
     *  `EFI_STRING_ID`、`EFI_HII_DATA`、`EFI_HII_TIME`、`EFI_HII_REF`等。

## VFR组件 ##

本文介绍常用的组件，比如按钮、选择框、标签等等，这些将结合IFR操作码说明，本节说明VFR的最基础组件。

### formset ###

每个vfr文件中都有且只有一个`formset`，它构成了界面的主体，其它的界面组件都在它内部，其结构如下：

formset
      guid      = TCG_CONFIG_FORM_SET_GUID, // GUID
      title     = STRING_TOKEN(STR_TPM_TITLE), // uni文件中定义的标记
      help      = STRING_TOKEN(STR_TPM_HELP), // uni文件中定义的标记
      classguid = EFI_HII_PLATFORM_SETUP_FORMSET_GUID, // GUID，可选
      class     = EFI_NETWORK_DEVICE_CLASS, // 数值，可选
      subclass  = 0x03, // 数值，可选
    
      // 剩余组件写在这里
    
    endformset;

剩余组件可以是图片、变量、DisableIf、SuppressIf、扩展等，用BNF表示就是：

`formset`和`endformset`配对使用。

具体的层级关系如下（目前的源代码中能够找到的vfr组件）：

![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center]

注意这里只包含了当前EDK代码中存在的组件，还有很多没有列举。

### form ###

`formset`内可以有若干个`form`，下面是一个例子：

form formid = FORM_MAIN_ID,
        title = STRING_TOKEN(STR_FORM_MAIN_TITLE);
      endform;

`formid`在一个`formset`中必须是唯一的；`title`来自uni文件中的标记。

### 变量 ###

VFR使用的变量有3种，分别是`varstore`、`efivarstore`和`namevaluevarstore`，下面是示例：

//
      // Define a Buffer Storage (EFI_IFR_VARSTORE)
      //
      varstore DRIVER_SAMPLE_CONFIGURATION,     // 数据结构，在头文件中定义
        varid = CONFIGURATION_VARSTORE_ID,      // 变量ID，可选，在创建操作码的函数中会用到，比如HiiCreateOneOfOpCode()
        name  = MyIfrNVData,                    // 变量名，CHAR16     VariableName[] = L"MyIfrNVData";
        guid  = DRIVER_SAMPLE_FORMSET_GUID;     // 变量GUID，跟变量名共同确定了UEFI变量
    
      //
      // Define a EFI variable Storage (EFI_IFR_VARSTORE_EFI)
      //
      efivarstore MY_EFI_VARSTORE_DATA,  // 数据结构，在头文件中定义
        attribute = EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_NON_VOLATILE,  // UEFI变量属性
        name  = MyEfiVar,  // 变量名，CHAR16     MyEfiVar[] = L"MyEfiVar";
        guid  = DRIVER_SAMPLE_FORMSET_GUID;  // 变量GUID，跟变量名共同确定了UEFI变量
    
      //
      // Define a Name/Value Storage (EFI_IFR_VARSTORE_NAME_VALUE)
      //
      namevaluevarstore MyNameValueVar,                // Define storage reference name in vfr
        name = STRING_TOKEN(STR_NAME_VALUE_VAR_NAME0), // Define Name list of this storage, refer it by MyNameValueVar[0]
        name = STRING_TOKEN(STR_NAME_VALUE_VAR_NAME1), // Define Name list of this storage, refer it by MyNameValueVar[1]
        name = STRING_TOKEN(STR_NAME_VALUE_VAR_NAME2), // Define Name list of this storage, refer it by MyNameValueVar[2]
        guid = DRIVER_SAMPLE_FORMSET_GUID;             // GUID of this Name/Value storage

上述的变量可以设置默认值，且默认值也可以不同，这通过`defaultstore`来实现：

defaultstore MyStandardDefault,
        prompt      = STRING_TOKEN(STR_STANDARD_DEFAULT_PROMPT),
        attribute   = 0x0000;                         // Default ID: 0000 standard default
    
      defaultstore MyManufactureDefault,
        prompt      = STRING_TOKEN(STR_MANUFACTURE_DEFAULT_PROMPT),
        attribute   = 0x0001;                         // Default ID: 0001 manufacture default

使用示例，可以在上述3中变量中使用：

numeric varid   = MyIfrNVData.HowOldAreYouInYears,  // varstore
                prompt  = STRING_TOKEN(STR_NUMERIC_STEP_PROMPT),
                help    = STRING_TOKEN(STR_NUMERIC_HELP2),
                minimum = 0,
                maximum = 243,
                step    = 1,
                default = 18, defaultstore = MyStandardDefault,     // This is standard default value
                default = 19, defaultstore = MyManufactureDefault,  // This is manufacture default value
    
        endnumeric;    
    
    	numeric varid   = MyEfiVar.Field8,                    // Reference of EFI variable storage
                questionid  = 0x1111,
                prompt  = STRING_TOKEN(STR_TALL_HEX_PROMPT),
                help    = STRING_TOKEN(STR_NUMERIC_HELP1),
                flags   = DISPLAY_UINT_HEX | INTERACTIVE,     // Display in HEX format (if not specified, default is in decimal format)
                minimum = 0,
                maximum = 250,
                default = 18, defaultstore = MyStandardDefault,     // This is standard default value
                default = 19, defaultstore = MyManufactureDefault,  // This is manufacture default value
    
        endnumeric;
    
        //
        // Define numeric using Name/Value Storage
        //
        numeric varid   = MyNameValueVar[0],     // This numeric take NameValueVar0 as storage
                prompt  = STRING_TOKEN(STR_NAME_VALUE_VAR_NAME0),
                help    = STRING_TOKEN(STR_NAME_VALUE_VAR_NAME0_HELP),
                //
                // Size should be defined for numeric when use Name/Value storage
                // Valid value for numerice size are: NUMERIC_SIZE_1, NUMERIC_SIZE_2, NUMERIC_SIZE_4 and NUMERIC_SIZE_8
                //
                flags   = NUMERIC_SIZE_1,        // Size of this numeric is 1 byte
                minimum = 0,
                maximum = 0xff,
                step    = 0,
                locked,
                default = 16, defaultstore = MyStandardDefault,     // This is standard default value
                default = 17, defaultstore = MyManufactureDefault,  // This is manufacture default value
        endnumeric;

### 控制 ###

有如下的3种控制显示的语句：

disableif ideqval MyIfrNVData.SuppressGrayOutSomething == 0x2;
          orderedlist
            varid       = MyIfrNVData.OrderedList,
            prompt      = STRING_TOKEN(STR_TEST_OPCODE),
            help        = STRING_TOKEN(STR_TEXT_HELP),
            flags       = RESET_REQUIRED,
            option text = STRING_TOKEN(STR_ONE_OF_TEXT1), value = 3, flags = 0;
            option text = STRING_TOKEN(STR_ONE_OF_TEXT2), value = 2, flags = 0;
            option text = STRING_TOKEN(STR_ONE_OF_TEXT3), value = 1, flags = 0;
            default     = {
        1,2,3},
          endlist;
        endif;
    
        grayoutif NOT ideqval MyIfrNVData.SuppressGrayOutSomething == 0x1;
          suppressif questionref(MyOneOf) == 0x0;
    
            checkbox varid   = MyIfrNVData.ChooseToActivateNuclearWeaponry,
                     prompt   = STRING_TOKEN(STR_CHECK_BOX_PROMPT),
                     help     = STRING_TOKEN(STR_CHECK_BOX_HELP),
                     //
                     // CHECKBOX_DEFAULT indicate this checkbox is marked with EFI_IFR_CHECKBOX_DEFAULT
                     // CHECKBOX_DEFAULT_MFG indicate EFI_IFR_CHECKBOX_DEFAULT_MFG.
                     //
                     flags    = CHECKBOX_DEFAULT | CHECKBOX_DEFAULT_MFG,
                     default  = TRUE,
            endcheckbox;
          endif;
        endif;

`disableif`表示不用，`suppressif`表示不显示，`grayoutif`表示显示但是不能操作（不能选中）。

还有控制跳转的语句：

goto FORM_BOOT_DEL_ID,
                prompt = STRING_TOKEN(STR_FORM_BOOT_DEL_TITLE),
                help = STRING_TOKEN(STR_FORM_BOOT_IMMEDIATE_HELP),
                flags = INTERACTIVE,
                key = FORM_BOOT_DEL_ID;

`FORM_BOOT_DEL_ID`对应到一个`form`的`formid`：

form formid = FORM_BOOT_DEL_ID,
           title = STRING_TOKEN(STR_FORM_BOOT_DEL_TITLE);
    
           label FORM_BOOT_DEL_ID;
           label LABEL_END;
      endform;

### 表达式 ###

VFR中可以包含表达式，比如`OR`、`AND`、`NOT`等等，作用跟c语言中类似。

## IFR操作码 ##

<table> 
 <thead> 
  <tr> 
   <th>操作码</th> 
   <th>值</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>EFI_IFR_FORM_OP</td> 
   <td>0x01</td> 
   <td>Form</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_SUBTITLE_OP</td> 
   <td>0x02</td> 
   <td>Subtitle statement</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_TEXT_OP</td> 
   <td>0x03</td> 
   <td>Static text/image statement</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_IMAGE_OP</td> 
   <td>0x04</td> 
   <td>Static image</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_ONE_OF_OP</td> 
   <td>0x05</td> 
   <td>One-of question</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_CHECKBOX_OP</td> 
   <td>0x06</td> 
   <td>Boolean question</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_NUMERIC_OP</td> 
   <td>0x07</td> 
   <td>Numeric question</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_PASSWORD_OP</td> 
   <td>0x08</td> 
   <td>Password string question</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_ONE_OF_OPTION_OP</td> 
   <td>0x09</td> 
   <td>Option</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_SUPPRESS_IF_OP</td> 
   <td>0x0A</td> 
   <td>Suppress if conditional</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_LOCKED_OP</td> 
   <td>0x0B</td> 
   <td>Marks statement/question as locked</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_ACTION_OP</td> 
   <td>0x0C</td> 
   <td>Button question</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_RESET_BUTTON_OP</td> 
   <td>0x0D</td> 
   <td>Reset button statement</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_FORM_SET_OP</td> 
   <td>0x0E</td> 
   <td>Form set</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_REF_OP</td> 
   <td>0x0F</td> 
   <td>Cross-reference statement</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_NO_SUBMIT_IF_OP</td> 
   <td>0x10</td> 
   <td>Error checking conditional</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_INCONSISTENT_IF_OP</td> 
   <td>0x11</td> 
   <td>Error checking conditional</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_EQ_ID_VAL_OP</td> 
   <td>0x12</td> 
   <td>Return true if question value equals UINT16</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_EQ_ID_ID_OP</td> 
   <td>0x13</td> 
   <td>Return true if question value equals another question value</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_EQ_ID_VAL_LIST_OP</td> 
   <td>0x14</td> 
   <td>Return true if question value is found in list of UINT16s</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_AND_OP</td> 
   <td>0x15</td> 
   <td>Push true if both sub-expressions returns true</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_OR_OP</td> 
   <td>0x16</td> 
   <td>Push true if either sub-expressions returns true</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_NOT_OP</td> 
   <td>0x17</td> 
   <td>Push false if sub-expression returns true, otherwise return true</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_RULE_OP</td> 
   <td>0x18</td> 
   <td>Create rule in current form</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_GRAY_OUT_IF_OP</td> 
   <td>0x19</td> 
   <td>Nested statements, questions or options will not be selectable if expression returns true</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_DATE_OP</td> 
   <td>0x1A</td> 
   <td>Date question</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_TIME_OP</td> 
   <td>0x1B</td> 
   <td>Time question</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_STRING_OP</td> 
   <td>0x1C</td> 
   <td>String question</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_REFRESH_OP</td> 
   <td>0x1D</td> 
   <td>Interval for refreshing a question</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_DISABLE_IF_OP</td> 
   <td>0x1E</td> 
   <td>Nested statements, questions or options will not be processed if expression returns true</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_ANIMATION_OP</td> 
   <td>0x1F</td> 
   <td>Animation associated with question statement, form or form set</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_TO_LOWER_OP</td> 
   <td>0x20</td> 
   <td>Convert a string on the expression stack to lower case</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_TO_UPPER_OP</td> 
   <td>0x21</td> 
   <td>Convert a string on the expression stack to upper case</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_MAP_OP</td> 
   <td>0x22</td> 
   <td>Convert one value to another by selecting a match from a list</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_ORDERED_LIST_OP</td> 
   <td>0x23</td> 
   <td>Set question</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_VARSTORE_OP</td> 
   <td>0x24</td> 
   <td>Define a buffer-style variable storage</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_VARSTORE_NAME_VALUE_OP</td> 
   <td>0x25</td> 
   <td>Define a name/value style variable storage</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_VARSTORE_EFI_OP</td> 
   <td>0x26</td> 
   <td>Define a UEFI variable style variable storage</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_VARSTORE_DEVICE_OP</td> 
   <td>0x27</td> 
   <td>Specify the device path to use for variable storage</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_VERSION_OP</td> 
   <td>0x28</td> 
   <td>Push the revision level of the UEFI Specification to which this Forms Processor is compliant</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_END_OP</td> 
   <td>0x29</td> 
   <td>Marks end of scope</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_MATCH_OP</td> 
   <td>0x2A</td> 
   <td>Push TRUE if string matches a pattern</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_GET_OP</td> 
   <td>0x2B</td> 
   <td>Return a stored value</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_SET_OP</td> 
   <td>0x2C</td> 
   <td>Change a stored value</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_READ_OP</td> 
   <td>0x2D</td> 
   <td>Provides a value for the current question or default</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_WRITE</td> 
   <td>0x2E</td> 
   <td>Change a value for the current question</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_EQUAL_OP</td> 
   <td>0x2F</td> 
   <td>Push TRUE if two expressions are equal</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_NOT_EQUAL_OP</td> 
   <td>0x30</td> 
   <td>Push TRUE if two expressions are not equal</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_GREATER_THAN_OP</td> 
   <td>0x31</td> 
   <td>Push TRUE if one expression is greater than another expression</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_GREATER_EQUAL_OP</td> 
   <td>0x32</td> 
   <td>Push TRUE if one expression is greater than or equal to another expression</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_LESS_THAN_OP</td> 
   <td>0x33</td> 
   <td>Push TRUE if one expression is less than another expression</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_LESS_EQUAL_OP</td> 
   <td>0x34</td> 
   <td>Push TRUE if one expression is less than or equal to another expression</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_BITWISE_AND_OP</td> 
   <td>0x35</td> 
   <td>Bitwise-AND two unsigned integers and push the result</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_BITWISE_OR_OP</td> 
   <td>0x36</td> 
   <td>Bitwise-OR two unsigned integers and push the result</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_BITWISE_NOT_OP</td> 
   <td>0x37</td> 
   <td>Bitwise-NOT an unsigned integer and push the result</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_SHIFT_LEFT_OP</td> 
   <td>0x38</td> 
   <td>Shift an unsigned integer left by a number of bits and push the result</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_SHIFT_RIGHT_OP</td> 
   <td>0x39</td> 
   <td>Shift an unsigned integer right by a number of bits and push the result</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_ADD_OP</td> 
   <td>0x3A</td> 
   <td>Add two unsigned integers and push the result</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_SUBTRACT_OP</td> 
   <td>0x3B</td> 
   <td>Subtract two unsigned integers and push the result</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_MULTIPLY_OP</td> 
   <td>0x3C</td> 
   <td>Multiply two unsigned integers and push the result</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_DIVIDE_OP</td> 
   <td>0x3D</td> 
   <td>Divide one unsigned integer by another and push the result</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_MODULO_OP</td> 
   <td>0x3E</td> 
   <td>Divide one unsigned integer by another and push the remainder</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_RULE_REF_OP</td> 
   <td>0x3F</td> 
   <td>Evaluate a rule</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_QUESTION_REF1_OP</td> 
   <td>0x40</td> 
   <td>Push a question’s value</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_QUESTION_REF2_OP</td> 
   <td>0x41</td> 
   <td>Push a question’s value</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_UINT8_OP<br>EFI_IFR_UINT16_OP<br>EFI_IFR_UINT32_OP<br>EFI_IFR_UINT64_OP</td> 
   <td>0x42<br>0x43<br>0x44<br>0x45</td> 
   <td>Push an 8-bit/16-bit/32-bit/64-bit unsigned integer</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_TRUE_OP</td> 
   <td>0x46</td> 
   <td>Push a boolean TRUE.</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_FALSE_OP</td> 
   <td>0x47</td> 
   <td>Push a boolean FALSE</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_TO_UINT_OP</td> 
   <td>0x48</td> 
   <td>Convert expression to an unsigned integer</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_TO_STRING_OP</td> 
   <td>0x49</td> 
   <td>Convert expression to a string</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_TO_BOOLEAN_OP</td> 
   <td>0x4A</td> 
   <td>Convert expression to a boolean</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_MID_OP</td> 
   <td>0x4B</td> 
   <td>Extract portion of string or buffer</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_FIND_OP</td> 
   <td>0x4C</td> 
   <td>Find a string in a string</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_TOKEN_OP</td> 
   <td>0x4D</td> 
   <td>Extract a delimited byte or character string from buffer or string</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_STRING_REF1_OP</td> 
   <td>0x4E</td> 
   <td>Push a string</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_STRING_REF2_OP</td> 
   <td>0x4F</td> 
   <td>Push a string</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_CONDITIONAL_OP</td> 
   <td>0x50</td> 
   <td>Duplicate one of two expressions depending on result of the first expression</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_QUESTION_REF3_OP</td> 
   <td>0x51</td> 
   <td>Push a question’s value from a different form</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_ZERO_OP</td> 
   <td>0x52</td> 
   <td>Push a zero</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_ONE_OP</td> 
   <td>0x53</td> 
   <td>Push a one</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_ONES_OP</td> 
   <td>0x54</td> 
   <td>Push a 0xFFFFFFFFFFFFFFFF</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_UNDEFINED_OP</td> 
   <td>0x55</td> 
   <td>Push Undefined</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_LENGTH_OP</td> 
   <td>0x56</td> 
   <td>Push length of buffer or string</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_DUP_OP</td> 
   <td>0x57</td> 
   <td>Duplicate top of expression stack</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_THIS_OP</td> 
   <td>0x58</td> 
   <td>Push the current question’s value</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_SPAN_OP</td> 
   <td>0x59</td> 
   <td>Return first matching/non-matching character in a string</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_VALUE_OP</td> 
   <td>0x5A</td> 
   <td>Provide a value for a question</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_DEFAULT_OP</td> 
   <td>0x5B</td> 
   <td>Provide a default value for a question</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_DEFAULTSTORE_OP</td> 
   <td>0x5C</td> 
   <td>Define a Default Type Declaration</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_FORM_MAP_OP</td> 
   <td>0x5D</td> 
   <td>Create a standards-map form</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_CATENATE_OP</td> 
   <td>0x5E</td> 
   <td>Push concatenated buffers or strings</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_GUID_OP</td> 
   <td>0x5F</td> 
   <td>An extensible GUIDed op-code</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_SECURITY_OP</td> 
   <td>0x60</td> 
   <td>Returns whether current user profile contains specified setup access privileges</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_MODAL_TAG_OP</td> 
   <td>0x61</td> 
   <td>Specify current form is modal</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_REFRESH_ID_OP</td> 
   <td>0x62</td> 
   <td>Establish an event group for refreshing a forms-based element</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_WARNING_IF</td> 
   <td>0x63</td> 
   <td>Warning conditional</td> 
  </tr> 
  <tr> 
   <td>EFI_IFR_MATCH2_OP</td> 
   <td>0x64</td> 
   <td>Push TRUE if string matches a Regular Expression pattern</td> 
  </tr> 
 </tbody> 
</table>

安装层级结构描述上述的操作码，结构如下：

![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 1]

安装表达式来描述上述的操作符，有如下的结构：

![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 2]

每种类型都有对应的结构体。对应的类型宏和结构体定义在MdePkg\\Include\\Uefi\\UefiInternalFormRepresentation.h中。另外还需要特别关注下面这种：

#define EFI_IFR_GUID_OP                0x5F

其结构体定义如下：

typedef struct _EFI_IFR_GUID {
        
      EFI_IFR_OP_HEADER        Header;
      EFI_GUID                 Guid;
      //Optional Data Follows
    } EFI_IFR_GUID;

可以看到它实际上也不是完整的版本，真正完整版本定义在MdeModulePkg\\Include\\Guid\\MdeModuleHii.h，它有不同的种类：

///
    /// GUIDed opcodes defined for EDKII implementation.
    ///
    #define EFI_IFR_TIANO_GUID \
      {
           0xf0b1735, 0x87a0, 0x4193, {
          0xb2, 0x66, 0x53, 0x8c, 0x38, 0xaf, 0x48, 0xce} }
    
    ///
    /// EDKII implementation extension opcodes, new extension can be added here later.
    ///
    #define EFI_IFR_EXTEND_OP_LABEL       0x0
    #define EFI_IFR_EXTEND_OP_BANNER      0x1
    #define EFI_IFR_EXTEND_OP_TIMEOUT     0x2
    #define EFI_IFR_EXTEND_OP_CLASS       0x3
    #define EFI_IFR_EXTEND_OP_SUBCLASS    0x4

定义的`Guid`目前只有`EFI_IFR_TIANO_GUID`，后面的数据根据不同的类型值不同，对应的结构体也不同。

[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_18_color_FFFFFF_t_70_g_se_x_16_pic_center]: https://img-blog.csdnimg.cn/3c1803511b554ab7a9f13fb45db21e79.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBAamlhbmd3ZWkwNTEy,size_18,color_FFFFFF,t_70,g_se,x_16#pic_center
[ee12d9514b97495eb5d82bd40a1a7a18.png_pic_center]: https://img-blog.csdnimg.cn/ee12d9514b97495eb5d82bd40a1a7a18.png#pic_center
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center]: https://img-blog.csdnimg.cn/f981a5e35d0d4e7598c1bc75fa22fbd4.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBAamlhbmd3ZWkwNTEy,size_20,color_FFFFFF,t_70,g_se,x_16#pic_center
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 1]: https://img-blog.csdnimg.cn/9c9b09cf5d1044dcbf707e5efa9587f8.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBAamlhbmd3ZWkwNTEy,size_20,color_FFFFFF,t_70,g_se,x_16#pic_center
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBAamlhbmd3ZWkwNTEy_size_20_color_FFFFFF_t_70_g_se_x_16_pic_center 2]: https://img-blog.csdnimg.cn/54bee15f57a94310881a1d2a82d1fc4c.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBAamlhbmd3ZWkwNTEy,size_20,color_FFFFFF,t_70,g_se,x_16#pic_center