]> git.proxmox.com Git - mirror_edk2.git/blobdiff - MdeModulePkg/Universal/DriverSampleDxe/DriverSample.c
sync comments, fix function header, rename variable name to follow coding style.
[mirror_edk2.git] / MdeModulePkg / Universal / DriverSampleDxe / DriverSample.c
index 45bfeaffcd0d7dc49d563b765522533d88f0d29d..c468bc5900a2b0d5669167cbac42a89ee04d2932 100644 (file)
@@ -1,5 +1,5 @@
 /** @file\r
-Copyright (c) 2004 - 2007, Intel Corporation\r
+Copyright (c) 2004 - 2008, Intel Corporation\r
 All rights reserved. This program and the accompanying materials\r
 are licensed and made available under the terms and conditions of the BSD License\r
 which accompanies this distribution.  The full text of the license may be found at\r
@@ -29,6 +29,8 @@ EFI_GUID   mInventoryGuid = INVENTORY_GUID;
 \r
 CHAR16     VariableName[] = L"MyIfrNVData";\r
 \r
+UINT8 VfrMyIfrNVDataBlockName[] = "BugBug";\r
+\r
 VOID\r
 EncodePassword (\r
   IN  CHAR16                      *Password,\r
@@ -259,6 +261,7 @@ ExtractConfig (
   PrivateData = DRIVER_SAMPLE_PRIVATE_FROM_THIS (This);\r
   HiiConfigRouting = PrivateData->HiiConfigRouting;\r
 \r
+  //\r
   //\r
   // Get Buffer Storage data from EFI variable\r
   //\r
@@ -274,6 +277,39 @@ ExtractConfig (
     return Status;\r
   }\r
 \r
+  if (Request == NULL) {\r
+    //\r
+    // Request is set to NULL, return all configurable elements together with ALTCFG\r
+    //\r
+    Status = ConstructConfigAltResp (\r
+               NULL,\r
+               NULL,\r
+               Results,\r
+               &mFormSetGuid,\r
+               VariableName,\r
+               PrivateData->DriverHandle[0],\r
+               &PrivateData->Configuration,\r
+               BufferSize,\r
+               VfrMyIfrNVDataBlockName,\r
+               2,\r
+               STRING_TOKEN (STR_STANDARD_DEFAULT_PROMPT),\r
+               VfrMyIfrNVDataDefault0000,\r
+               STRING_TOKEN (STR_MANUFACTURE_DEFAULT_PROMPT),\r
+               VfrMyIfrNVDataDefault0001\r
+               );\r
+\r
+    return Status;\r
+  }\r
+\r
+  //\r
+  // Check routing data in <ConfigHdr>.\r
+  // Note: if only one Storage is used, then this checking could be skipped.\r
+  //\r
+  if (!IsConfigHdrMatch (Request, &mFormSetGuid, VariableName)) {\r
+    *Progress = Request;\r
+    return EFI_NOT_FOUND;\r
+  }\r
+\r
   //\r
   // Convert buffer data to <ConfigResp> by helper function BlockToConfig()\r
   //\r
@@ -320,9 +356,21 @@ RouteConfig (
   DRIVER_SAMPLE_PRIVATE_DATA       *PrivateData;\r
   EFI_HII_CONFIG_ROUTING_PROTOCOL  *HiiConfigRouting;\r
 \r
+  if (Configuration == NULL) {\r
+    return EFI_INVALID_PARAMETER;\r
+  }\r
+\r
   PrivateData = DRIVER_SAMPLE_PRIVATE_FROM_THIS (This);\r
   HiiConfigRouting = PrivateData->HiiConfigRouting;\r
 \r
+  // Check routing data in <ConfigHdr>.\r
+  // Note: if only one Storage is used, then this checking could be skipped.\r
+  //\r
+  if (!IsConfigHdrMatch (Configuration, &mFormSetGuid, VariableName)) {\r
+    *Progress = Configuration;\r
+    return EFI_NOT_FOUND;\r
+  }\r
+\r
   //\r
   // Get Buffer Storage data from EFI variable\r
   //\r
@@ -405,6 +453,7 @@ DriverCallback (
   EFI_STATUS                      Status;\r
   EFI_HII_UPDATE_DATA             UpdateData;\r
   IFR_OPTION                      *IfrOptionList;\r
+  UINT8                           MyVar;\r
 \r
   if ((Value == NULL) || (ActionRequest == NULL)) {\r
     return EFI_INVALID_PARAMETER;\r
@@ -416,12 +465,9 @@ DriverCallback (
   switch (QuestionId) {\r
   case 0x1234:\r
     //\r
-    // Create dynamic page for this interactive goto\r
+    // Initialize the container for dynamic opcodes\r
     //\r
-    UpdateData.BufferSize = 0x1000;\r
-    UpdateData.Offset = 0;\r
-    UpdateData.Data = AllocatePool (0x1000);\r
-    ASSERT (UpdateData.Data != NULL);\r
+    IfrLibInitUpdateData (&UpdateData, 0x1000);\r
 \r
     IfrOptionList = AllocatePool (2 * sizeof (IFR_OPTION));\r
     ASSERT (IfrOptionList != NULL);\r
@@ -433,62 +479,127 @@ DriverCallback (
     IfrOptionList[1].StringToken  = STRING_TOKEN (STR_BOOT_OPTION2);\r
     IfrOptionList[1].Value.u8     = 2;\r
 \r
-    CreateActionOpCode (\r
-      0x1237,\r
-      STRING_TOKEN(STR_EXIT_TEXT),\r
-      STRING_TOKEN(STR_EXIT_TEXT),\r
-      EFI_IFR_FLAG_CALLBACK,\r
-      0,\r
-      &UpdateData\r
-      );\r
-\r
-    CreateOneOfOpCode (\r
-      0x8001,\r
-      0,\r
-      0,\r
-      STRING_TOKEN (STR_ONE_OF_PROMPT),\r
-      STRING_TOKEN (STR_ONE_OF_HELP),\r
-      EFI_IFR_FLAG_CALLBACK,\r
-      EFI_IFR_NUMERIC_SIZE_1,\r
-      IfrOptionList,\r
-      2,\r
-      &UpdateData\r
-      );\r
-\r
-    CreateOrderedListOpCode (\r
-      0x8002,\r
-      0,\r
-      0,\r
-      STRING_TOKEN (STR_BOOT_OPTIONS),\r
-      STRING_TOKEN (STR_BOOT_OPTIONS),\r
-      EFI_IFR_FLAG_RESET_REQUIRED,\r
-      0,\r
-      EFI_IFR_NUMERIC_SIZE_1,\r
-      10,\r
-      IfrOptionList,\r
-      2,\r
-      &UpdateData\r
-      );\r
-\r
-    CreateGotoOpCode (\r
-      1,\r
-      STRING_TOKEN (STR_GOTO_FORM1),\r
-      STRING_TOKEN (STR_GOTO_HELP),\r
-      0,\r
-      0x8003,\r
-      &UpdateData\r
-      );\r
-\r
-    Status = IfrLibUpdateForm (\r
-               PrivateData->HiiHandle[0],\r
-               &mFormSetGuid,\r
-               0x1234,\r
-               0x1234,\r
-               TRUE,\r
-               &UpdateData\r
-               );\r
-    gBS->FreePool (IfrOptionList);\r
-    gBS->FreePool (UpdateData.Data);\r
+      CreateActionOpCode (\r
+        0x1237,                           // Question ID\r
+        STRING_TOKEN(STR_EXIT_TEXT),      // Prompt text\r
+        STRING_TOKEN(STR_EXIT_TEXT),      // Help text\r
+        EFI_IFR_FLAG_CALLBACK,            // Question flag\r
+        0,                                // Action String ID\r
+        &UpdateData                       // Container for dynamic created opcodes\r
+        );\r
+    \r
+      //\r
+      // Prepare initial value for the dynamic created oneof Question\r
+      //\r
+      PrivateData->Configuration.DynamicOneof = 2;\r
+      Status = gRT->SetVariable(\r
+                      VariableName,\r
+                      &mFormSetGuid,\r
+                      EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS,\r
+                      sizeof (DRIVER_SAMPLE_CONFIGURATION),\r
+                      &PrivateData->Configuration\r
+                      );\r
+      CreateOneOfOpCode (\r
+        0x8001,                           // Question ID (or call it "key")\r
+        CONFIGURATION_VARSTORE_ID,        // VarStore ID\r
+        DYNAMIC_ONE_OF_VAR_OFFSET,        // Offset in Buffer Storage\r
+        STRING_TOKEN (STR_ONE_OF_PROMPT), // Question prompt text\r
+        STRING_TOKEN (STR_ONE_OF_HELP),   // Question help text\r
+        EFI_IFR_FLAG_CALLBACK,            // Question flag\r
+        EFI_IFR_NUMERIC_SIZE_1,           // Data type of Question Value\r
+        IfrOptionList,                    // Option list\r
+        2,                                // Number of options in Option list\r
+        &UpdateData                       // Container for dynamic created opcodes\r
+        );\r
+    \r
+      CreateOrderedListOpCode (\r
+        0x8002,                           // Question ID\r
+        CONFIGURATION_VARSTORE_ID,        // VarStore ID\r
+        DYNAMIC_ORDERED_LIST_VAR_OFFSET,  // Offset in Buffer Storage\r
+        STRING_TOKEN (STR_BOOT_OPTIONS),  // Question prompt text\r
+        STRING_TOKEN (STR_BOOT_OPTIONS),  // Question help text\r
+        EFI_IFR_FLAG_RESET_REQUIRED,      // Question flag\r
+        0,                                // Ordered list flag, e.g. EFI_IFR_UNIQUE_SET\r
+        EFI_IFR_NUMERIC_SIZE_1,           // Data type of Question value\r
+        5,                                // Maximum container\r
+        IfrOptionList,                    // Option list\r
+        2,                                // Number of options in Option list\r
+        &UpdateData                       // Container for dynamic created opcodes\r
+        );\r
+    \r
+      CreateGotoOpCode (\r
+        1,                                // Target Form ID\r
+        STRING_TOKEN (STR_GOTO_FORM1),    // Prompt text\r
+        STRING_TOKEN (STR_GOTO_HELP),     // Help text\r
+        0,                                // Question flag\r
+        0x8003,                           // Question ID\r
+        &UpdateData                       // Container for dynamic created opcodes\r
+        );\r
+    \r
+      Status = IfrLibUpdateForm (\r
+                 PrivateData->HiiHandle[0],  // HII handle\r
+                 &mFormSetGuid,              // Formset GUID\r
+                 0x1234,                     // Form ID\r
+                 0x1234,                     // Label for where to insert opcodes\r
+                 TRUE,                       // Append or replace\r
+                 &UpdateData                 // Dynamic created opcodes\r
+                 );\r
+      gBS->FreePool (IfrOptionList);\r
+      IfrLibFreeUpdateData (&UpdateData);\r
+      break;\r
+    \r
+    case 0x5678:\r
+      //\r
+      // We will reach here once the Question is refreshed\r
+      //\r
+      IfrLibInitUpdateData (&UpdateData, 0x1000);\r
+    \r
+      IfrOptionList = AllocatePool (2 * sizeof (IFR_OPTION));\r
+      ASSERT (IfrOptionList != NULL);\r
+    \r
+      CreateActionOpCode (\r
+        0x1237,                           // Question ID\r
+        STRING_TOKEN(STR_EXIT_TEXT),      // Prompt text\r
+        STRING_TOKEN(STR_EXIT_TEXT),      // Help text\r
+        EFI_IFR_FLAG_CALLBACK,            // Question flag\r
+        0,                                // Action String ID\r
+        &UpdateData                       // Container for dynamic created opcodes\r
+        );\r
+    \r
+      Status = IfrLibUpdateForm (\r
+                 PrivateData->HiiHandle[0],  // HII handle\r
+                 &mFormSetGuid,              // Formset GUID\r
+                 3,                          // Form ID\r
+                 0x2234,                     // Label for where to insert opcodes\r
+                 TRUE,                       // Append or replace\r
+                 &UpdateData                 // Dynamic created opcodes\r
+                 );\r
+      IfrLibFreeUpdateData (&UpdateData);\r
+    \r
+      //\r
+      // Refresh the Question value\r
+      //\r
+      PrivateData->Configuration.DynamicRefresh++;\r
+      Status = gRT->SetVariable(\r
+                      VariableName,\r
+                      &mFormSetGuid,\r
+                      EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS,\r
+                      sizeof (DRIVER_SAMPLE_CONFIGURATION),\r
+                      &PrivateData->Configuration\r
+                      );\r
+    \r
+      //\r
+      // Change an EFI Variable storage (MyEfiVar) asynchronous, this will cause\r
+      // the first statement in Form 3 be suppressed\r
+      //\r
+      MyVar = 111;\r
+      Status = gRT->SetVariable(\r
+                      L"MyVar",\r
+                      &mFormSetGuid,\r
+                      EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS,\r
+                      1,\r
+                      &MyVar\r
+                      );\r
     break;\r
 \r
   case 0x1237:\r