2 Entry and initialization module for the browser.
4 Copyright (c) 2006 - 2007 Intel Corporation. <BR>
5 All rights reserved. This program and the accompanying materials
6 are licensed and made available under the terms and conditions of the BSD License
7 which accompanies this distribution. The full text of the license may be found at
8 http://opensource.org/licenses/bsd-license.php
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
19 FUNCTIION_KEY_SETTING gFunctionKeySettingTable
[] = {
39 NONE_FUNCTION_KEY_SETTING
60 NONE_FUNCTION_KEY_SETTING
81 NONE_FUNCTION_KEY_SETTING
84 // BMM File Explorer Formset.
102 NONE_FUNCTION_KEY_SETTING
108 InitializeBinaryStructures (
109 IN EFI_HII_HANDLE
*Handle
,
110 IN BOOLEAN UseDatabase
,
111 IN EFI_IFR_PACKET
*Packet
,
112 IN UINT8
*NvMapOverride
,
113 IN UINTN NumberOfIfrImages
,
114 EFI_FILE_FORM_TAGS
**FileFormTagsHead
119 InitializeTagStructures (
120 IN EFI_IFR_BINARY
*BinaryData
,
121 OUT EFI_FILE_FORM_TAGS
*FileFormTags
127 IN UINTN NumberOfIfrImages
,
128 IN EFI_FILE_FORM_TAGS
*FileFormTagsHead
,
129 IN UINT8
*CallbackData
135 IN EFI_HII_PROTOCOL
*Hii
,
136 IN EFI_HII_HANDLE HiiHandle
,
137 IN EFI_IFR_PACKET
*Packet
,
138 IN EFI_IFR_BINARY
*BinaryData
151 IN EFI_FORM_BROWSER_PROTOCOL
* This
,
152 IN BOOLEAN UseDatabase
,
153 IN EFI_HII_HANDLE
* Handle
,
154 IN UINTN HandleCount
,
155 IN EFI_IFR_PACKET
* Packet
,
156 IN EFI_HANDLE CallbackHandle
,
157 IN UINT8
*NvMapOverride
,
158 IN EFI_SCREEN_DESCRIPTOR
*ScreenDimensions
, OPTIONAL
159 OUT BOOLEAN
*ResetRequired OPTIONAL
165 This is the routine which an external caller uses to direct the browser
166 where to obtain it's information.
170 UseDatabase - If set to TRUE, then all information is retrieved from the HII database handle specified
171 If set to FALSE, then the passed in Packet and CallbackHandle is used and Handle is ignored
173 Handle - A pointer to an array of Handles. If HandleCount > 1 we display a list of the formsets for the handles specified
175 HandleCount - The number of Handles specified in Handle.
177 Packet - Valid only if UseDatabase is FALSE. Packet defines the pages being passed into
178 the browser. This is composed of IFR data as well as String information.
180 CallbackHandle - The handle which contains the calling driver's EFI_FORM_CALLBACK_PROTOCOL interface.
182 ScreenDimenions - This allows the browser to be called so that it occupies a portion of the physical screen instead of
183 dynamically determining the screen dimensions.
185 NvMapOverride - This buffer is used only when there is no NV variable to define the current settings and the caller
186 needs to provide to the browser the current settings for the "fake" NV variable. If used, no saving
187 of an NV variable will be possible. This parameter is also ignored if HandleCount > 1.
193 EFI_FORM_CALLBACK_PROTOCOL
*FormCallback
;
194 EFI_FILE_FORM_TAGS
*FileFormTagsHead
;
195 UI_MENU_OPTION
*Selection
;
196 UI_MENU_OPTION
*AltSelection
;
200 EFI_HII_HANDLE BackupHandle
;
202 ZeroMem (&gScreenDimensions
, sizeof (EFI_SCREEN_DESCRIPTOR
));
204 gPreviousValue
= AllocatePool (0x1000);
205 CallbackData
= AllocatePool (0x10000);
206 ASSERT (gPreviousValue
!= NULL
);
207 ASSERT (CallbackData
!= NULL
);
211 // Seed the dimensions in the global
213 gST
->ConOut
->QueryMode (
215 gST
->ConOut
->Mode
->Mode
,
216 &gScreenDimensions
.RightColumn
,
217 &gScreenDimensions
.BottomRow
220 if (ScreenDimensions
!= NULL
) {
222 // Check local dimension vs. global dimension.
224 if ((gScreenDimensions
.RightColumn
< ScreenDimensions
->RightColumn
) ||
225 (gScreenDimensions
.BottomRow
< ScreenDimensions
->BottomRow
)
227 return EFI_INVALID_PARAMETER
;
230 // Local dimension validation.
232 if ((ScreenDimensions
->RightColumn
> ScreenDimensions
->LeftColumn
) &&
233 (ScreenDimensions
->BottomRow
> ScreenDimensions
->TopRow
) &&
234 ((ScreenDimensions
->RightColumn
- ScreenDimensions
->LeftColumn
) > 2) &&
236 (ScreenDimensions
->BottomRow
- ScreenDimensions
->TopRow
) > STATUS_BAR_HEIGHT
+
237 SCROLL_ARROW_HEIGHT
*
239 FRONT_PAGE_HEADER_HEIGHT
+
244 CopyMem (&gScreenDimensions
, ScreenDimensions
, sizeof (EFI_SCREEN_DESCRIPTOR
));
246 return EFI_INVALID_PARAMETER
;
251 gOptionBlockWidth
= (CHAR16
) ((gScreenDimensions
.RightColumn
- gScreenDimensions
.LeftColumn
) / 3);
252 gHelpBlockWidth
= gOptionBlockWidth
;
253 gPromptBlockWidth
= gOptionBlockWidth
;
256 // Initialize the strings for the browser, upon exit of the browser, the strings will be freed
258 InitializeBrowserStrings ();
260 gFunctionKeySetting
= DEFAULT_FUNCTION_KEY_SETTING
;
261 gClassOfVfr
= EFI_SETUP_APPLICATION_SUBCLASS
;
262 gResetRequired
= FALSE
;
263 gExitRequired
= FALSE
;
264 gSaveRequired
= FALSE
;
265 gNvUpdateRequired
= FALSE
;
269 BackupHandle
= *Handle
;
270 gMenuRefreshHead
= NULL
;
271 ASSERT (CallbackData
);
272 ZeroMem (CallbackData
, 0x10000);
275 // We can recurse through this and might need to re-allocate this particular buffer
277 if (gPreviousValue
== NULL
) {
278 gPreviousValue
= AllocatePool (0x1000);
279 ASSERT (gPreviousValue
!= NULL
);
285 if (CallbackHandle
!= NULL
) {
287 // Retrieve the Callback protocol interface
289 Status
= gBS
->HandleProtocol (
291 &gEfiFormCallbackProtocolGuid
,
292 (VOID
**) &FormCallback
295 if (EFI_ERROR (Status
)) {
296 FreePool (CallbackData
);
303 // Initializes all the internal state structures for all IFR images in system
305 Status
= InitializeBinaryStructures (Handle
, UseDatabase
, Packet
, NvMapOverride
, HandleCount
, &FileFormTagsHead
);
307 if (EFI_ERROR (Status
)) {
308 FreePool (CallbackData
);
312 // Beginning of the Presentation of the Data
314 if (UseDatabase
&& (HandleCount
> 1)) {
315 Selection
= DisplayHomePage (HandleCount
, FileFormTagsHead
, CallbackData
);
318 // If passing something specific, we know there is only one Ifr
320 Selection
= AllocateZeroPool (sizeof (UI_MENU_OPTION
));
321 ASSERT (Selection
!= NULL
);
322 Selection
->IfrNumber
= 0;
323 Selection
->Handle
= Handle
[0];
329 if (UseDatabase
&& (HandleCount
> 1)) {
330 if (Selection
== NULL
) {
331 FreePool (CallbackData
);
336 // Launch the setup browser with the user's selection information
338 AltSelection
= SetupBrowser (Selection
, Callback
, FileFormTagsHead
, CallbackData
);
341 // If the caller cares about Reset status, we can return to the caller if something happened that required a reset
343 if (ResetRequired
!= NULL
) {
344 *ResetRequired
= gResetRequired
;
347 if (Callback
&& (AltSelection
!= NULL
)) {
348 if ((FormCallback
!= NULL
) && (FormCallback
->Callback
!= NULL
)) {
349 Status
= FormCallback
->Callback (
351 AltSelection
->ThisTag
->Key
,
353 (EFI_HII_CALLBACK_PACKET
**) &Packet
358 *Handle
= BackupHandle
;
360 if (EFI_ERROR (Status
)) {
361 FreePool (CallbackData
);
365 if (Callback
&& (AltSelection
== NULL
)) {
366 FreePool (CallbackData
);
370 if (UseDatabase
&& (HandleCount
> 1)) {
373 if (gBinaryDataHead
->UnRegisterOnExit
) {
374 Hii
->RemovePack (Hii
, Handle
[0]);
378 ((AltSelection
->ThisTag
->SubClass
== EFI_FRONT_PAGE_SUBCLASS
) ||
379 (AltSelection
->ThisTag
->SubClass
== EFI_SINGLE_USE_SUBCLASS
))) {
381 // If this is the FrontPage, return after every selection
383 FreePool (Selection
);
387 // Clean up the allocated data buffers
389 FreeData (FileFormTagsHead
, NULL
, NULL
);
391 gST
->ConOut
->SetAttribute (gST
->ConOut
, EFI_TEXT_ATTR (EFI_LIGHTGRAY
, EFI_BLACK
));
392 gST
->ConOut
->ClearScreen (gST
->ConOut
);
394 FreePool (CallbackData
);
398 FreePool (Selection
);
402 // Clean up the allocated data buffers
404 FreeData (FileFormTagsHead
, NULL
, NULL
);
406 gST
->ConOut
->ClearScreen (gST
->ConOut
);
409 FreePool (CallbackData
);
414 } while (!EFI_ERROR (Status
));
416 FreePool (CallbackData
);
423 IN EFI_HANDLE ImageHandle
,
424 IN EFI_SYSTEM_TABLE
*SystemTable
432 (Standard EFI Image entry - EFI_IMAGE_ENTRY_POINT)
435 EFI_SUCCESS - Setup loaded.
441 EFI_FORM_CONFIGURATION_DATA
*FormData
;
442 EFI_FORM_BROWSER_PROTOCOL
*FormBrowser
;
444 EFI_HII_PACKAGES
*PackageList
;
447 // There will be only one FormConfig in the system
448 // If there is another out there, someone is trying to install us
449 // again. Fail that scenario.
451 Status
= gBS
->LocateProtocol (
452 &gEfiFormBrowserProtocolGuid
,
454 (VOID
**) &FormBrowser
460 // If there was no error, assume there is an installation and fail to load
462 if (!EFI_ERROR (Status
)) {
463 return EFI_DEVICE_ERROR
;
466 FormData
= AllocatePool (sizeof (EFI_FORM_CONFIGURATION_DATA
));
468 if (FormData
== NULL
) {
469 return EFI_OUT_OF_RESOURCES
;
474 FormData
->Signature
= EFI_FORM_DATA_SIGNATURE
;
475 FormData
->FormConfig
.SendForm
= SendForm
;
476 FormData
->FormConfig
.CreatePopUp
= CreateDialog
;
479 // There should only be one HII image
481 Status
= gBS
->LocateProtocol (
482 &gEfiHiiProtocolGuid
,
484 (VOID
**) &FormData
->Hii
487 ASSERT_EFI_ERROR (Status
);
491 PackageList
= PreparePackages (1, &gEfiFormBrowserProtocolGuid
, SetupBrowserStrings
);
493 Status
= Hii
->NewPack (Hii
, PackageList
, &gHiiHandle
);
495 FreePool (PackageList
);
498 // Install protocol interface
501 Status
= gBS
->InstallProtocolInterface (
503 &gEfiFormBrowserProtocolGuid
,
504 EFI_NATIVE_INTERFACE
,
505 &FormData
->FormConfig
508 ASSERT_EFI_ERROR (Status
);
510 BannerData
= AllocateZeroPool (sizeof (BANNER_DATA
));
511 ASSERT (BannerData
!= NULL
);
513 Status
= InstallPrint ();
520 IN UINT8
*RawFormSet
,
522 IN EFI_FILE_FORM_TAGS
*FileFormTags
,
523 IN UINT16 CurrentVariable
528 Initialize question tag's members.
531 Tag - Pointer of the current EFI_TAG structure.
532 RawFormSet - Pointer of the formset raw data.
533 Index - Offset of the current opcode in the Ifr raw data.
534 FileFormTags - Pointer of current EFI_FILE_FORM_TAGS structure.
535 CurrentVariable - Current variable number.
541 EFI_VARIABLE_DEFINITION
*VariableDefinition
;
543 Tag
->NumberOfLines
= 1;
544 Tag
->VariableNumber
= CurrentVariable
;
545 CopyMem (&Tag
->Id
, &((EFI_IFR_ONE_OF
*) &RawFormSet
[Index
])->QuestionId
, sizeof (UINT16
));
546 CopyMem (&Tag
->StorageStart
, &((EFI_IFR_ONE_OF
*) &RawFormSet
[Index
])->QuestionId
, sizeof (UINT16
));
547 CopyMem (&Tag
->StorageWidth
, &((EFI_IFR_ONE_OF
*) &RawFormSet
[Index
])->Width
, sizeof (UINT8
));
548 CopyMem (&Tag
->Text
, &((EFI_IFR_ONE_OF
*) &RawFormSet
[Index
])->Prompt
, sizeof (UINT16
));
549 CopyMem (&Tag
->Help
, &((EFI_IFR_ONE_OF
*) &RawFormSet
[Index
])->Help
, sizeof (UINT16
));
551 VariableDefinition
= FileFormTags
->VariableDefinitions
;
553 for (; VariableDefinition
!= NULL
; VariableDefinition
= VariableDefinition
->Next
) {
555 // Have we found the correct variable for the request?
557 if (CurrentVariable
== VariableDefinition
->VariableId
) {
558 if (VariableDefinition
->VariableSize
< (UINTN
) (Tag
->StorageStart
+ Tag
->StorageWidth
)) {
559 VariableDefinition
->VariableFakeSize
= (UINT16
) (VariableDefinition
->VariableFakeSize
+ Tag
->StorageWidth
);
562 if (VariableDefinition
->NvRamMap
!= NULL
) {
564 // If it is an 8bit or 16bit width, then move it to Tag->Value, otherwise
565 // we will never be looking for the data in Tag->Value (e.g. strings, password, etc)
567 if (Tag
->StorageWidth
== (UINT16
) 1) {
568 CopyMem (&Tag
->Value
, &VariableDefinition
->NvRamMap
[Tag
->StorageStart
], sizeof (UINT16
));
571 if (Tag
->StorageWidth
== (UINT16
) 2) {
574 VariableDefinition
->NvRamMap
[Tag
->StorageStart
] +
575 (VariableDefinition
->NvRamMap
[Tag
->StorageStart
+ 1] * 0x100)
577 CopyMem (&Tag
->Value
, &Index
, sizeof (UINT16
));
581 CopyMem (&Tag
->Value
, &Index
, sizeof (UINT16
));
591 IN UINT8
*RawFormSet
,
593 IN UINT16 NumberOfLines
,
594 IN EFI_FILE_FORM_TAGS
*FileFormTags
,
595 IN UINT16 CurrentVariable
600 Initialize numeric tag's members.
603 Tag - Pointer of the current EFI_TAG structure.
604 RawFormSet - Pointer of the formset raw data.
605 Index - Offset of the current opcode in the Ifr raw data.
606 NumberOfLines - Number of lines this opcode occupied.
607 FileFormTags - Pointer of current EFI_FILE_FORM_TAGS structure.
608 CurrentVariable - Current variable number.
614 EFI_VARIABLE_DEFINITION
*VariableDefinition
;
616 Tag
->NumberOfLines
= NumberOfLines
;
617 Tag
->VariableNumber
= CurrentVariable
;
618 CopyMem (&Tag
->Id
, &((EFI_IFR_ONE_OF
*) &RawFormSet
[Index
])->QuestionId
, sizeof (UINT16
));
619 CopyMem (&Tag
->StorageStart
, &((EFI_IFR_ONE_OF
*) &RawFormSet
[Index
])->QuestionId
, sizeof (UINT16
));
620 CopyMem (&Tag
->StorageWidth
, &((EFI_IFR_ONE_OF
*) &RawFormSet
[Index
])->Width
, sizeof (UINT8
));
621 CopyMem (&Tag
->Text
, &((EFI_IFR_ONE_OF
*) &RawFormSet
[Index
])->Prompt
, sizeof (UINT16
));
622 CopyMem (&Tag
->Help
, &((EFI_IFR_ONE_OF
*) &RawFormSet
[Index
])->Help
, sizeof (UINT16
));
623 CopyMem (&Tag
->Minimum
, &((EFI_IFR_NUMERIC
*) &RawFormSet
[Index
])->Minimum
, sizeof (UINT16
));
624 CopyMem (&Tag
->Maximum
, &((EFI_IFR_NUMERIC
*) &RawFormSet
[Index
])->Maximum
, sizeof (UINT16
));
625 CopyMem (&Tag
->Step
, &((EFI_IFR_NUMERIC
*) &RawFormSet
[Index
])->Step
, sizeof (UINT16
));
626 CopyMem (&Tag
->Default
, &((EFI_IFR_NUMERIC
*) &RawFormSet
[Index
])->Default
, sizeof (UINT16
));
627 Tag
->ResetRequired
= (BOOLEAN
) (((EFI_IFR_NUMERIC
*) &RawFormSet
[Index
])->Flags
& EFI_IFR_FLAG_RESET_REQUIRED
);
629 VariableDefinition
= FileFormTags
->VariableDefinitions
;
631 for (; VariableDefinition
!= NULL
; VariableDefinition
= VariableDefinition
->Next
) {
633 // Have we found the correct variable for the request?
635 if (CurrentVariable
== VariableDefinition
->VariableId
) {
636 if (VariableDefinition
->VariableSize
<= (UINTN
) (Tag
->StorageStart
+ Tag
->StorageWidth
)) {
637 if (Tag
->StorageWidth
== 0) {
638 VariableDefinition
->VariableFakeSize
= (UINT16
) (VariableDefinition
->VariableFakeSize
+ 2);
640 VariableDefinition
->VariableFakeSize
= (UINT16
) (VariableDefinition
->VariableFakeSize
+ Tag
->StorageWidth
);
644 if (VariableDefinition
->NvRamMap
!= NULL
) {
646 // If it is an 8bit or 16bit width, then move it to Tag->Value, otherwise
647 // we will never be looking for the data in Tag->Value (e.g. strings, password, etc)
649 if (Tag
->StorageWidth
== (UINT16
) 1) {
650 CopyMem (&Tag
->Value
, &VariableDefinition
->NvRamMap
[Tag
->StorageStart
], sizeof (UINT16
));
653 if (Tag
->StorageWidth
== (UINT16
) 2) {
656 VariableDefinition
->NvRamMap
[Tag
->StorageStart
] +
657 (VariableDefinition
->NvRamMap
[Tag
->StorageStart
+ 1] * 0x100)
659 CopyMem (&Tag
->Value
, &Index
, sizeof (UINT16
));
662 CopyMem (&Tag
->Value
, &Tag
->Default
, sizeof (UINT16
));
671 IN UINT8
*RawFormSet
,
672 IN OUT UINT16
*NumberOfTags
678 // Assume on entry we are pointing to an OpCode - reasonably this should
679 // be a FormOp since the purpose is to count the tags in a particular Form.
681 for (Index
= 0; RawFormSet
[Index
] != EFI_IFR_END_FORM_OP
;) {
683 // If we encounter the end of a form set, bail out
685 if (RawFormSet
[Index
] == EFI_IFR_END_FORM_SET_OP
) {
689 // We treat date/time internally as three op-codes
691 if (RawFormSet
[Index
] == EFI_IFR_DATE_OP
|| RawFormSet
[Index
] == EFI_IFR_TIME_OP
) {
692 *NumberOfTags
= (UINT16
) (*NumberOfTags
+ 3);
695 // Assume that we could have no more tags than op-codes
700 Index
= (UINT16
) (Index
+ RawFormSet
[Index
+ 1]);
703 // Increase the tag count by one so it is inclusive of the end_form_op
710 AddNextInconsistentTag (
711 IN OUT EFI_INCONSISTENCY_DATA
**InconsistentTagsPtr
716 Initialize the next inconsistent tag data and add it to the inconsistent tag list.
719 InconsistentTagsPtr - Pointer of the inconsistent tag's pointer.
726 EFI_INCONSISTENCY_DATA
*PreviousInconsistentTags
;
727 EFI_INCONSISTENCY_DATA
*InconsistentTags
;
729 InconsistentTags
= *InconsistentTagsPtr
;
731 // We just hit the end of an inconsistent expression. Let's allocate the ->Next structure
733 InconsistentTags
->Next
= AllocatePool (sizeof (EFI_INCONSISTENCY_DATA
));
734 ASSERT (InconsistentTags
->Next
!= NULL
);
737 // Preserve current Tag entry
739 PreviousInconsistentTags
= InconsistentTags
;
741 InconsistentTags
= InconsistentTags
->Next
;
744 // This will zero on the entry including the ->Next so I don't have to do it
746 ZeroMem (InconsistentTags
, sizeof (EFI_INCONSISTENCY_DATA
));
749 // Point our Previous field to the previous entry
751 InconsistentTags
->Previous
= PreviousInconsistentTags
;
753 *InconsistentTagsPtr
= InconsistentTags
;
760 InitializeTagStructures (
761 IN EFI_IFR_BINARY
*BinaryData
,
762 OUT EFI_FILE_FORM_TAGS
*FileFormTags
768 UINT16 QuestionIndex
;
772 EFI_FORM_TAGS
*FormTags
;
773 EFI_FORM_TAGS
*SavedFormTags
;
774 EFI_INCONSISTENCY_DATA
*InconsistentTags
;
775 EFI_VARIABLE_DEFINITION
*VariableDefinitions
;
780 UINT16 CurrentVariable
;
781 UINT16 CurrentVariable2
;
784 // Initialize some Index variable and Status
790 CurrentVariable2
= 0;
793 Status
= EFI_SUCCESS
;
794 FormTags
= &FileFormTags
->FormTags
;
795 FormTags
->Next
= NULL
;
796 if (FileFormTags
->InconsistentTags
== NULL
) {
797 InconsistentTags
= NULL
;
799 InconsistentTags
= FileFormTags
->InconsistentTags
;
802 if (FileFormTags
->VariableDefinitions
== NULL
) {
803 VariableDefinitions
= NULL
;
805 VariableDefinitions
= FileFormTags
->VariableDefinitions
;
808 // RawFormSet now points to the beginning of the forms portion of
809 // the specific IFR Binary.
811 RawFormSet
= (UINT8
*) BinaryData
->FormBinary
;
814 // Determine the number of tags for the first form
816 GetTagCount (&RawFormSet
[0], &NumberOfTags
);
818 SavedFormTags
= FormTags
;
820 if (FormTags
->Tags
!= NULL
) {
823 // Advance FormTags to the last entry
825 for (; FormTags
->Next
!= NULL
; FormTags
= FormTags
->Next
)
829 // Walk through each of the tags and free the IntList allocation
831 for (Index
= 0; Index
< NumberOfTags
; Index
++) {
832 if (FormTags
->Tags
[Index
].IntList
!= NULL
) {
833 FreePool (FormTags
->Tags
[Index
].IntList
);
837 FreePool (FormTags
->Tags
);
839 ASSERT (FormTags
->Next
== NULL
);
841 FormTags
->Tags
= NULL
;
843 FormTags
= SavedFormTags
;
845 } while (FormTags
->Next
!= NULL
);
851 // Test for an allocated buffer. If already allocated this is due to having called this routine
852 // once for sizing of the NV storage. We then loaded the NV variable and can correctly initialize
853 // the tag structure with current values from the NV
855 if (FormTags
->Tags
== NULL
) {
857 // Allocate memory for our tags on the first form
859 FormTags
->Tags
= AllocateZeroPool (NumberOfTags
* sizeof (EFI_TAG
));
860 ASSERT (FormTags
->Tags
);
863 // Test for an allocated buffer. If already allocated this is due to having called this routine
864 // once for sizing of the NV storage. We then loaded the NV variable and can correctly initialize
865 // the tag structure with current values from the NV
867 if (InconsistentTags
== NULL
) {
869 // We just hit the end of an inconsistent expression. Let's allocate the ->Next structure
871 InconsistentTags
= AllocateZeroPool (sizeof (EFI_INCONSISTENCY_DATA
));
872 ASSERT (InconsistentTags
!= NULL
);
874 FileFormTags
->InconsistentTags
= InconsistentTags
;
877 ZeroMem (FormTags
->Tags
, NumberOfTags
* sizeof (EFI_TAG
));
879 for (CurrTag
= 0; RawFormSet
[Index
] != EFI_IFR_END_FORM_SET_OP
; CurrTag
++) {
881 // Operand = IFR OpCode
883 FormTags
->Tags
[CurrTag
].Operand
= RawFormSet
[Index
];
886 // Assume for now 0 lines occupied by this OpCode
888 FormTags
->Tags
[CurrTag
].NumberOfLines
= 0;
890 FormTags
->Tags
[CurrTag
].Class
= Class
;
891 FormTags
->Tags
[CurrTag
].SubClass
= SubClass
;
894 // Determine the length of the Tag so we can later skip to the next tag in the form
896 TagLength
= RawFormSet
[Index
+ 1];
900 // Operate on the Found OpCode
902 switch (RawFormSet
[Index
]) {
904 case EFI_IFR_FORM_OP
:
906 // If there was no variable op-code defined, create a dummy entry for one
908 if (FileFormTags
->VariableDefinitions
== NULL
) {
909 FileFormTags
->VariableDefinitions
= AllocateZeroPool (sizeof (EFI_VARIABLE_DEFINITION
));
910 ASSERT (FileFormTags
->VariableDefinitions
!= NULL
);
913 &FormTags
->Tags
[CurrTag
],
914 (VOID
*) &RawFormSet
[Index
],
915 FileFormTags
->VariableDefinitions
918 IfrToFormTag (RawFormSet
[Index
], &FormTags
->Tags
[CurrTag
], (VOID
*) &RawFormSet
[Index
], NULL
);
922 case EFI_IFR_SUBTITLE_OP
:
923 case EFI_IFR_TEXT_OP
:
925 IfrToFormTag (RawFormSet
[Index
], &FormTags
->Tags
[CurrTag
], (VOID
*) &RawFormSet
[Index
], NULL
);
928 case EFI_IFR_VARSTORE_OP
:
929 if (FileFormTags
->VariableDefinitions
== NULL
) {
930 VariableDefinitions
= AllocateZeroPool (sizeof (EFI_VARIABLE_DEFINITION
));
931 ASSERT (VariableDefinitions
!= NULL
);
932 FileFormTags
->VariableDefinitions
= VariableDefinitions
;
937 &FormTags
->Tags
[CurrTag
],
938 (VOID
*) &RawFormSet
[Index
],
939 FileFormTags
->VariableDefinitions
943 case EFI_IFR_VARSTORE_SELECT_OP
:
944 IfrToFormTag (RawFormSet
[Index
], &FormTags
->Tags
[CurrTag
], (VOID
*) &RawFormSet
[Index
], NULL
);
945 CopyMem (&CurrentVariable
, &((EFI_IFR_VARSTORE_SELECT
*) &RawFormSet
[Index
])->VarId
, sizeof (UINT16
));
946 CurrentVariable2
= CurrentVariable
;
949 case EFI_IFR_VARSTORE_SELECT_PAIR_OP
:
950 IfrToFormTag (RawFormSet
[Index
], &FormTags
->Tags
[CurrTag
], (VOID
*) &RawFormSet
[Index
], NULL
);
951 CopyMem(&CurrentVariable
, &((EFI_IFR_VARSTORE_SELECT_PAIR
*)&RawFormSet
[Index
])->VarId
, sizeof (UINT16
));
954 &((EFI_IFR_VARSTORE_SELECT_PAIR
*) &RawFormSet
[Index
])->SecondaryVarId
,
959 case EFI_IFR_END_FORM_OP
:
961 // Test for an allocated buffer. If already allocated this is due to having called this routine
962 // once for sizing of the NV storage. We then loaded the NV variable and can correctly initialize
963 // the tag structure with current values from the NV
965 if (FormTags
->Next
== NULL
) {
967 // We just hit the end of a form. Let's allocate the ->Next structure
969 FormTags
->Next
= AllocatePool (sizeof (EFI_FORM_TAGS
));
970 ASSERT (FormTags
->Next
);
973 FormTags
= FormTags
->Next
;
974 ZeroMem (FormTags
, sizeof (EFI_FORM_TAGS
));
977 // Reset the tag count to one
982 // Reset the CurrTag value (it will be incremented, after this case statement
983 // so set to a negative one so that we get the desired effect.) Fish can beat me later.
988 // Determine the number of tags after this form. If this is the last
989 // form, then we will count the endformset and preserve that information
990 // in the tag structure.
992 GetTagCount (&RawFormSet
[Index
+ TagLength
], &NumberOfTags
);
995 // Allocate memory for our tags
997 FormTags
->Tags
= AllocateZeroPool (NumberOfTags
* sizeof (EFI_TAG
));
998 ASSERT (FormTags
->Tags
);
1002 // Two types of tags constitute the One Of question: a one-of header and
1003 // several one-of options.
1005 case EFI_IFR_ONE_OF_OP
:
1006 case EFI_IFR_ORDERED_LIST_OP
:
1007 GetQuestionHeader (&FormTags
->Tags
[CurrTag
], RawFormSet
, Index
, FileFormTags
, CurrentVariable
);
1010 // Store away the CurrTag since what follows will be the answer that we
1011 // need to place into the appropriate location in the tag array
1014 // record for setting default later
1016 QuestionIndex
= (UINT16
) CurrTag
;
1019 case EFI_IFR_ONE_OF_OPTION_OP
:
1020 IfrToFormTag (RawFormSet
[Index
], &FormTags
->Tags
[CurrTag
], (VOID
*) &RawFormSet
[Index
], NULL
);
1021 FormTags
->Tags
[QuestionIndex
].Flags
= ((EFI_IFR_ONE_OF_OPTION
*) &RawFormSet
[Index
])->Flags
;
1023 &FormTags
->Tags
[QuestionIndex
].Key
,
1024 &((EFI_IFR_ONE_OF_OPTION
*) &RawFormSet
[Index
])->Key
,
1027 FormTags
->Tags
[QuestionIndex
].ResetRequired
= (BOOLEAN
) (FormTags
->Tags
[QuestionIndex
].Flags
& EFI_IFR_FLAG_RESET_REQUIRED
);
1030 case EFI_IFR_CHECKBOX_OP
:
1031 GetQuestionHeader (&FormTags
->Tags
[CurrTag
], RawFormSet
, Index
, FileFormTags
, CurrentVariable
);
1032 IfrToFormTag (RawFormSet
[Index
], &FormTags
->Tags
[CurrTag
], (VOID
*) &RawFormSet
[Index
], NULL
);
1035 case EFI_IFR_NUMERIC_OP
:
1036 GetNumericHeader (&FormTags
->Tags
[CurrTag
], RawFormSet
, Index
, (UINT16
) 1, FileFormTags
, CurrentVariable
);
1037 IfrToFormTag (RawFormSet
[Index
], &FormTags
->Tags
[CurrTag
], (VOID
*) &RawFormSet
[Index
], NULL
);
1040 case EFI_IFR_DATE_OP
:
1042 // Date elements come in as a Year, Month, Day. We need to process them as a country-based
1043 // Order. It is much easier to do it here than anywhere else.
1045 // For US standards - we want Month/Day/Year, thus we advance "Index" +1, +2, +0 while CurrTag is +0, +1, +2
1048 &FormTags
->Tags
[CurrTag
],
1050 (UINT16
) (Index
+ TagLength
),
1057 // The current language selected + the Date operand
1059 FormTags
->Tags
[CurrTag
+ 1].Operand
= RawFormSet
[Index
];
1061 &FormTags
->Tags
[CurrTag
+ 1],
1063 (UINT16
) (Index
+ TagLength
+ RawFormSet
[Index
+ TagLength
+ 1]),
1070 // The current language selected + the Date operand
1072 FormTags
->Tags
[CurrTag
+ 2].Operand
= RawFormSet
[Index
];
1073 GetNumericHeader (&FormTags
->Tags
[CurrTag
+ 2], RawFormSet
, Index
, (UINT16
) 1, FileFormTags
, CurrentVariable
);
1075 CurrTag
= (INT16
) (CurrTag
+ 2);
1077 Index
= (UINT16
) (Index
+ TagLength
);
1081 TagLength
= RawFormSet
[Index
+ 1];
1082 Index
= (UINT16
) (Index
+ TagLength
);
1086 TagLength
= RawFormSet
[Index
+ 1];
1089 case EFI_IFR_TIME_OP
:
1090 GetNumericHeader (&FormTags
->Tags
[CurrTag
], RawFormSet
, Index
, (UINT16
) 0, FileFormTags
, CurrentVariable
);
1094 // Override the GetQuestionHeader information - date/time are treated very differently
1096 FormTags
->Tags
[CurrTag
].NumberOfLines
= 1;
1100 // The premise is that every date/time op-code have 3 elements, the first 2 have 0 lines
1101 // associated with them, and the third has 1 line to allow to space beyond the choice.
1107 case EFI_IFR_PASSWORD_OP
:
1108 case EFI_IFR_STRING_OP
:
1109 GetQuestionHeader (&FormTags
->Tags
[CurrTag
], RawFormSet
, Index
, FileFormTags
, CurrentVariable
);
1110 IfrToFormTag (RawFormSet
[Index
], &FormTags
->Tags
[CurrTag
], (VOID
*) &RawFormSet
[Index
], NULL
);
1113 case EFI_IFR_SUPPRESS_IF_OP
:
1114 case EFI_IFR_GRAYOUT_IF_OP
:
1115 InconsistentTags
->Operand
= ((EFI_IFR_INCONSISTENT
*) &RawFormSet
[Index
])->Header
.OpCode
;
1119 // Since this op-code doesn't use the next field(s), initialize them with something invalid.
1120 // Unfortunately 0 is a valid offset value for a QuestionId
1122 InconsistentTags
->QuestionId1
= INVALID_OFFSET_VALUE
;
1123 InconsistentTags
->QuestionId2
= INVALID_OFFSET_VALUE
;
1126 // Test for an allocated buffer. If already allocated this is due to having called this routine
1127 // once for sizing of the NV storage. We then loaded the NV variable and can correctly initialize
1128 // the tag structure with current values from the NV
1130 if (InconsistentTags
->Next
== NULL
) {
1131 AddNextInconsistentTag (&InconsistentTags
);
1135 InconsistentTags
= InconsistentTags
->Next
;
1138 case EFI_IFR_FORM_SET_OP
:
1140 &FormTags
->Tags
[CurrTag
].GuidValue
,
1141 &((EFI_IFR_FORM_SET
*) &RawFormSet
[Index
])->Guid
,
1145 &FormTags
->Tags
[CurrTag
].CallbackHandle
,
1146 &((EFI_IFR_FORM_SET
*) &RawFormSet
[Index
])->CallbackHandle
,
1147 sizeof (EFI_PHYSICAL_ADDRESS
)
1149 CopyMem (&FormTags
->Tags
[CurrTag
].Class
, &((EFI_IFR_FORM_SET
*) &RawFormSet
[Index
])->Class
, sizeof (UINT8
));
1151 &FormTags
->Tags
[CurrTag
].SubClass
,
1152 &((EFI_IFR_FORM_SET
*) &RawFormSet
[Index
])->SubClass
,
1156 &FormTags
->Tags
[CurrTag
].NvDataSize
,
1157 &((EFI_IFR_FORM_SET
*) &RawFormSet
[Index
])->NvDataSize
,
1160 Class
= ((EFI_IFR_FORM_SET
*) &RawFormSet
[Index
])->Class
;
1161 SubClass
= ((EFI_IFR_FORM_SET
*) &RawFormSet
[Index
])->SubClass
;
1163 // If the formset has a size value, that means someone must be using this, so create a variable
1164 // We also shall reserve the formid of 0 for this specific purpose.
1166 if ((FileFormTags
->VariableDefinitions
== NULL
) && (FormTags
->Tags
[CurrTag
].NvDataSize
> 0)) {
1167 FileFormTags
->VariableDefinitions
= AllocateZeroPool (sizeof (EFI_VARIABLE_DEFINITION
));
1168 ASSERT (FileFormTags
->VariableDefinitions
!= NULL
);
1171 &FormTags
->Tags
[CurrTag
],
1172 (VOID
*) &RawFormSet
[Index
],
1173 FileFormTags
->VariableDefinitions
1176 IfrToFormTag (RawFormSet
[Index
], &FormTags
->Tags
[CurrTag
], (VOID
*) &RawFormSet
[Index
], NULL
);
1180 case EFI_IFR_BANNER_OP
:
1181 if (gClassOfVfr
== EFI_FRONT_PAGE_SUBCLASS
) {
1183 CopyMem (&TempValue
, &((EFI_IFR_BANNER
*) &RawFormSet
[Index
])->Alignment
, sizeof (UINT8
));
1185 // If this is the special timeout value, we will dynamically figure out where to put it
1186 // Also the least significant byte refers to the TimeOut desired.
1188 if (TempValue
== EFI_IFR_BANNER_TIMEOUT
) {
1189 CopyMem (&FrontPageTimeOutTitle
, &((EFI_IFR_BANNER
*) &RawFormSet
[Index
])->Title
, sizeof (UINT16
));
1190 if (FrontPageTimeOutValue
!= (INT16
) -1) {
1191 CopyMem (&FrontPageTimeOutValue
, &((EFI_IFR_BANNER
*) &RawFormSet
[Index
])->LineNumber
, sizeof (UINT16
));
1197 &BannerData
->Banner
[((EFI_IFR_BANNER
*) &RawFormSet
[Index
])->LineNumber
][
1198 ((EFI_IFR_BANNER
*) &RawFormSet
[Index
])->Alignment
],
1199 &((EFI_IFR_BANNER
*) &RawFormSet
[Index
])->Title
,
1205 case EFI_IFR_INCONSISTENT_IF_OP
:
1207 &FormTags
->Tags
[CurrTag
].Text
,
1208 &((EFI_IFR_INCONSISTENT
*) &RawFormSet
[Index
])->Popup
,
1213 InconsistentTags
->Operand
= ((EFI_IFR_INCONSISTENT
*) &RawFormSet
[Index
])->Header
.OpCode
;
1214 CopyMem (&InconsistentTags
->Popup
, &((EFI_IFR_INCONSISTENT
*) &RawFormSet
[Index
])->Popup
, sizeof (UINT16
));
1217 // Since this op-code doesn't use the next field(s), initialize them with something invalid.
1218 // Unfortunately 0 is a valid offset value for a QuestionId
1220 InconsistentTags
->QuestionId1
= INVALID_OFFSET_VALUE
;
1221 InconsistentTags
->QuestionId2
= INVALID_OFFSET_VALUE
;
1223 InconsistentTags
->VariableNumber
= CurrentVariable
;
1226 // Test for an allocated buffer. If already allocated this is due to having called this routine
1227 // once for sizing of the NV storage. We then loaded the NV variable and can correctly initialize
1228 // the tag structure with current values from the NV
1230 if (InconsistentTags
->Next
== NULL
) {
1231 AddNextInconsistentTag (&InconsistentTags
);
1235 InconsistentTags
= InconsistentTags
->Next
;
1238 case EFI_IFR_EQ_ID_VAL_OP
:
1239 IfrToFormTag (RawFormSet
[Index
], &FormTags
->Tags
[CurrTag
], (VOID
*) &RawFormSet
[Index
], NULL
);
1241 InconsistentTags
->Operand
= ((EFI_IFR_EQ_ID_VAL
*) &RawFormSet
[Index
])->Header
.OpCode
;
1242 CopyMem (&InconsistentTags
->Value
, &((EFI_IFR_EQ_ID_VAL
*) &RawFormSet
[Index
])->Value
, sizeof (UINT16
));
1244 &InconsistentTags
->QuestionId1
,
1245 &((EFI_IFR_EQ_ID_VAL
*) &RawFormSet
[Index
])->QuestionId
,
1250 // Since this op-code doesn't use the next field(s), initialize them with something invalid.
1251 // Unfortunately 0 is a valid offset value for a QuestionId
1253 InconsistentTags
->Width
= FormTags
->Tags
[CurrTag
].StorageWidth
;
1254 InconsistentTags
->QuestionId2
= INVALID_OFFSET_VALUE
;
1255 InconsistentTags
->ConsistencyId
= gConsistencyId
;
1256 FormTags
->Tags
[CurrTag
].ConsistencyId
= gConsistencyId
;
1258 InconsistentTags
->VariableNumber
= CurrentVariable
;
1261 // Test for an allocated buffer. If already allocated this is due to having called this routine
1262 // once for sizing of the NV storage. We then loaded the NV variable and can correctly initialize
1263 // the tag structure with current values from the NV
1265 if (InconsistentTags
->Next
== NULL
) {
1266 AddNextInconsistentTag (&InconsistentTags
);
1270 InconsistentTags
= InconsistentTags
->Next
;
1273 case EFI_IFR_EQ_VAR_VAL_OP
:
1274 IfrToFormTag (RawFormSet
[Index
], &FormTags
->Tags
[CurrTag
], (VOID
*) &RawFormSet
[Index
], NULL
);
1276 InconsistentTags
->Operand
= ((EFI_IFR_EQ_VAR_VAL
*) &RawFormSet
[Index
])->Header
.OpCode
;
1277 CopyMem (&InconsistentTags
->Value
, &((EFI_IFR_EQ_VAR_VAL
*) &RawFormSet
[Index
])->Value
, sizeof (UINT16
));
1279 &InconsistentTags
->QuestionId1
,
1280 &((EFI_IFR_EQ_VAR_VAL
*) &RawFormSet
[Index
])->VariableId
,
1285 // Since this op-code doesn't use the next field(s), initialize them with something invalid.
1286 // Unfortunately 0 is a valid offset value for a QuestionId
1288 InconsistentTags
->QuestionId2
= INVALID_OFFSET_VALUE
;
1289 InconsistentTags
->ConsistencyId
= gConsistencyId
;
1290 FormTags
->Tags
[CurrTag
].ConsistencyId
= gConsistencyId
;
1292 InconsistentTags
->VariableNumber
= CurrentVariable
;
1295 // Test for an allocated buffer. If already allocated this is due to having called this routine
1296 // once for sizing of the NV storage. We then loaded the NV variable and can correctly initialize
1297 // the tag structure with current values from the NV
1299 if (InconsistentTags
->Next
== NULL
) {
1300 AddNextInconsistentTag (&InconsistentTags
);
1304 InconsistentTags
= InconsistentTags
->Next
;
1307 case EFI_IFR_EQ_ID_ID_OP
:
1308 IfrToFormTag (RawFormSet
[Index
], &FormTags
->Tags
[CurrTag
], (VOID
*) &RawFormSet
[Index
], NULL
);
1310 InconsistentTags
->Operand
= ((EFI_IFR_EQ_ID_ID
*) &RawFormSet
[Index
])->Header
.OpCode
;
1312 &InconsistentTags
->QuestionId1
,
1313 &((EFI_IFR_EQ_ID_ID
*) &RawFormSet
[Index
])->QuestionId1
,
1317 &InconsistentTags
->QuestionId2
,
1318 &((EFI_IFR_EQ_ID_ID
*) &RawFormSet
[Index
])->QuestionId2
,
1322 InconsistentTags
->Width
= FormTags
->Tags
[CurrTag
].StorageWidth
;
1323 InconsistentTags
->ConsistencyId
= gConsistencyId
;
1324 FormTags
->Tags
[CurrTag
].ConsistencyId
= gConsistencyId
;
1326 InconsistentTags
->VariableNumber
= CurrentVariable
;
1327 InconsistentTags
->VariableNumber2
= CurrentVariable2
;
1330 // Test for an allocated buffer. If already allocated this is due to having called this routine
1331 // once for sizing of the NV storage. We then loaded the NV variable and can correctly initialize
1332 // the tag structure with current values from the NV
1334 if (InconsistentTags
->Next
== NULL
) {
1335 AddNextInconsistentTag (&InconsistentTags
);
1339 InconsistentTags
= InconsistentTags
->Next
;
1342 case EFI_IFR_AND_OP
:
1344 case EFI_IFR_NOT_OP
:
1347 case EFI_IFR_TRUE_OP
:
1348 case EFI_IFR_FALSE_OP
:
1349 InconsistentTags
->Operand
= ((EFI_IFR_NOT
*) &RawFormSet
[Index
])->Header
.OpCode
;
1352 // Since this op-code doesn't use the next field(s), initialize them with something invalid.
1353 // Unfortunately 0 is a valid offset value for a QuestionId
1357 // Reserve INVALID_OFFSET_VALUE - 1 for TRUE or FALSE because they are inconsistency tags also, but
1358 // have no coresponding id. The examination of id is needed by evaluating boolean expression.
1360 if (RawFormSet
[Index
] == EFI_IFR_TRUE_OP
||
1361 RawFormSet
[Index
] == EFI_IFR_FALSE_OP
) {
1362 InconsistentTags
->QuestionId1
= INVALID_OFFSET_VALUE
- 1;
1364 InconsistentTags
->QuestionId1
= INVALID_OFFSET_VALUE
;
1366 InconsistentTags
->QuestionId2
= INVALID_OFFSET_VALUE
;
1367 InconsistentTags
->ConsistencyId
= gConsistencyId
;
1368 FormTags
->Tags
[CurrTag
].ConsistencyId
= gConsistencyId
;
1371 // Test for an allocated buffer. If already allocated this is due to having called this routine
1372 // once for sizing of the NV storage. We then loaded the NV variable and can correctly initialize
1373 // the tag structure with current values from the NV
1375 if (InconsistentTags
->Next
== NULL
) {
1376 AddNextInconsistentTag (&InconsistentTags
);
1380 InconsistentTags
= InconsistentTags
->Next
;
1383 case EFI_IFR_EQ_ID_LIST_OP
:
1384 IfrToFormTag (RawFormSet
[Index
], &FormTags
->Tags
[CurrTag
], (VOID
*) &RawFormSet
[Index
], NULL
);
1386 InconsistentTags
->Operand
= ((EFI_IFR_EQ_ID_LIST
*) &RawFormSet
[Index
])->Header
.OpCode
;
1388 &InconsistentTags
->QuestionId1
,
1389 &((EFI_IFR_EQ_ID_LIST
*) &RawFormSet
[Index
])->QuestionId
,
1393 &InconsistentTags
->ListLength
,
1394 &((EFI_IFR_EQ_ID_LIST
*) &RawFormSet
[Index
])->ListLength
,
1397 InconsistentTags
->ValueList
= FormTags
->Tags
[CurrTag
].IntList
;
1400 // Since this op-code doesn't use the next field(s), initialize them with something invalid.
1401 // Unfortunately 0 is a valid offset value for a QuestionId
1403 InconsistentTags
->Width
= FormTags
->Tags
[CurrTag
].StorageWidth
;
1404 InconsistentTags
->QuestionId2
= INVALID_OFFSET_VALUE
;
1405 InconsistentTags
->ConsistencyId
= gConsistencyId
;
1406 FormTags
->Tags
[CurrTag
].ConsistencyId
= gConsistencyId
;
1409 // Test for an allocated buffer. If already allocated this is due to having called this routine
1410 // once for sizing of the NV storage. We then loaded the NV variable and can correctly initialize
1411 // the tag structure with current values from the NV
1413 if (InconsistentTags
->Next
== NULL
) {
1414 AddNextInconsistentTag (&InconsistentTags
);
1418 InconsistentTags
= InconsistentTags
->Next
;
1421 case EFI_IFR_END_IF_OP
:
1422 InconsistentTags
->Operand
= ((EFI_IFR_END_EXPR
*) &RawFormSet
[Index
])->Header
.OpCode
;
1425 // Since this op-code doesn't use the next field(s), initialize them with something invalid.
1426 // Unfortunately 0 is a valid offset value for a QuestionId
1428 InconsistentTags
->QuestionId1
= INVALID_OFFSET_VALUE
;
1429 InconsistentTags
->QuestionId2
= INVALID_OFFSET_VALUE
;
1432 // Test for an allocated buffer. If already allocated this is due to having called this routine
1433 // once for sizing of the NV storage. We then loaded the NV variable and can correctly initialize
1434 // the tag structure with current values from the NV
1436 if (InconsistentTags
->Next
== NULL
) {
1437 AddNextInconsistentTag (&InconsistentTags
);
1441 InconsistentTags
= InconsistentTags
->Next
;
1444 case EFI_IFR_END_ONE_OF_OP
:
1453 // Per spec., we ignore ops that we don't know how to deal with. Skip to next tag
1455 Index
= (UINT16
) (Index
+ TagLength
);
1460 // When we eventually exit, make sure we mark the last tag with an op-code
1462 FormTags
->Tags
[CurrTag
].Operand
= RawFormSet
[Index
];
1464 IfrToFormTag (RawFormSet
[Index
], &FormTags
->Tags
[CurrTag
], (VOID
*) &RawFormSet
[Index
], NULL
);
1467 // Place this as an end of the database marker
1469 InconsistentTags
->Operand
= 0xFF;
1472 // This is the Head of the linked list of pages. Each page is an array of tags
1474 FormTags
= &FileFormTags
->FormTags
;
1475 InconsistentTags
= FileFormTags
->InconsistentTags
;
1477 for (; InconsistentTags
->Operand
!= 0xFF;) {
1478 if (InconsistentTags
->QuestionId1
!= INVALID_OFFSET_VALUE
) {
1480 // Search the tags for the tag which corresponds to this ID
1482 for (CurrTag
= 0; FormTags
->Tags
[0].Operand
!= EFI_IFR_END_FORM_SET_OP
; CurrTag
++) {
1484 // If we hit the end of a form, go to the next set of Tags.
1485 // Remember - EndFormSet op-codes sit on their own page after an end form.
1487 if (FormTags
->Tags
[CurrTag
].Operand
== EFI_IFR_END_FORM_OP
) {
1489 // Reset the CurrTag value (it will be incremented, after this case statement
1490 // so set to a negative one so that we get the desired effect.) Fish can beat me later.
1493 FormTags
= FormTags
->Next
;
1497 if (FormTags
->Tags
[CurrTag
].Id
== InconsistentTags
->QuestionId1
) {
1498 FormTags
->Tags
[CurrTag
].Consistency
++;
1503 FormTags
= &FileFormTags
->FormTags
;
1505 if (InconsistentTags
->QuestionId2
!= INVALID_OFFSET_VALUE
) {
1507 // Search the tags for the tag which corresponds to this ID
1509 for (CurrTag
= 0; FormTags
->Tags
[CurrTag
].Operand
!= EFI_IFR_END_FORM_SET_OP
; CurrTag
++) {
1511 // If we hit the end of a form, go to the next set of Tags.
1512 // Remember - EndFormSet op-codes sit on their own page after an end form.
1514 if (FormTags
->Tags
[CurrTag
].Operand
== EFI_IFR_END_FORM_OP
) {
1516 // Reset the CurrTag value (it will be incremented, after this case statement
1517 // so set to a negative one so that we get the desired effect.) Fish can beat me later.
1520 FormTags
= FormTags
->Next
;
1524 if (FormTags
->Tags
[CurrTag
].Id
== InconsistentTags
->QuestionId2
) {
1525 FormTags
->Tags
[CurrTag
].Consistency
++;
1530 InconsistentTags
= InconsistentTags
->Next
;
1541 CHAR16
*HomePageString
;
1542 CHAR16
*HomeEscapeString
;
1545 // Displays the Header and Footer borders
1547 DisplayPageFrame ();
1549 HomePageString
= GetToken (STRING_TOKEN (HOME_PAGE_TITLE
), gHiiHandle
);
1550 HomeEscapeString
= GetToken (STRING_TOKEN (HOME_ESCAPE_STRING
), gHiiHandle
);
1552 gST
->ConOut
->SetAttribute (gST
->ConOut
, EFI_YELLOW
| EFI_BRIGHT
);
1554 // PrintStringAt ((gScreenDimensions.RightColumn - GetStringWidth(HomePageString)/2)/2, 1, HomePageString);
1557 (gScreenDimensions
.RightColumn
+ gScreenDimensions
.LeftColumn
- GetStringWidth (HomePageString
) / 2) / 2,
1562 gScreenDimensions
.LeftColumn
+ 2,
1563 gScreenDimensions
.BottomRow
- 3,
1564 (CHAR16
*) L
"%c%c%s",
1570 gScreenDimensions
.RightColumn
- (GetStringWidth (HomeEscapeString
) / 2) - 2,
1571 gScreenDimensions
.BottomRow
- 3,
1575 gST
->ConOut
->SetAttribute (gST
->ConOut
, EFI_TEXT_ATTR (EFI_LIGHTGRAY
, EFI_BLACK
));
1576 FreePool (HomeEscapeString
);
1577 FreePool (HomePageString
);
1584 IN STRING_REF Token
,
1585 IN EFI_HII_HANDLE HiiHandle
1589 Routine Description:
1591 Get the string based on the TokenID and HII Handle.
1595 Token - The Token ID.
1596 HiiHandle - Handle of Ifr to be fetched.
1609 // Set default string size assumption at no more than 256 bytes
1611 BufferLength
= 0x100;
1613 Buffer
= AllocateZeroPool (BufferLength
);
1614 ASSERT (Buffer
!= NULL
);
1616 Status
= Hii
->GetString (Hii
, HiiHandle
, Token
, TRUE
, NULL
, &BufferLength
, Buffer
);
1618 if (EFI_ERROR (Status
)) {
1619 if (Status
== EFI_BUFFER_TOO_SMALL
) {
1621 // Free the old pool
1626 // Allocate new pool with correct value
1628 Buffer
= AllocatePool (BufferLength
);
1629 ASSERT (Buffer
!= NULL
);
1631 Status
= Hii
->GetString (Hii
, HiiHandle
, Token
, TRUE
, NULL
, &BufferLength
, Buffer
);
1633 if (!EFI_ERROR (Status
)) {
1638 ASSERT_EFI_ERROR (Status
);
1647 IN UINTN NumberOfIfrImages
,
1648 IN EFI_FILE_FORM_TAGS
*FileFormTagsHead
1653 EFI_IFR_BINARY
*IfrBinary
;
1655 EFI_FILE_FORM_TAGS
*FileFormTags
;
1656 EFI_FORM_TAGS LocalTags
;
1658 FileFormTags
= FileFormTagsHead
;
1662 Status
= EFI_SUCCESS
;
1665 // If there are no images
1667 if (NumberOfIfrImages
== 0) {
1668 Status
= EFI_NO_MEDIA
;
1672 // IfrBinary points to the beginning of the Binary data linked-list
1674 IfrBinary
= gBinaryDataHead
;
1677 // Print the entries which were in the default language.
1679 for (Index
= 0; Index
< NumberOfIfrImages
; Index
++) {
1680 LocalTags
= FileFormTags
->FormTags
;
1683 // Populate the Menu
1685 StringPtr
= GetToken (IfrBinary
->TitleToken
, IfrBinary
->Handle
);
1688 // If the default language doesn't exist, don't add a menu option yet
1690 if (StringPtr
[0] != CHAR_NULL
) {
1692 // We are NOT!! removing this StringPtr buffer via FreePool since it is being used in the menuoptions, we will do
1693 // it in UiFreeMenu.
1695 UiAddMenuOption (StringPtr
, IfrBinary
->Handle
, LocalTags
.Tags
, IfrBinary
->FormBinary
, Index
);
1698 // Advance to the next HII handle
1700 IfrBinary
= IfrBinary
->Next
;
1701 FileFormTags
= FileFormTags
->NextFile
;
1710 IN UINTN NumberOfIfrImages
,
1711 IN EFI_FILE_FORM_TAGS
*FileFormTagsHead
,
1712 IN UINT8
*CallbackData
1716 UI_MENU_OPTION
*Selection
;
1719 // This prints the basic home page template which the user sees
1723 Status
= PopulateHomePage (NumberOfIfrImages
, FileFormTagsHead
);
1725 if (EFI_ERROR (Status
)) {
1730 Selection
= UiDisplayMenu (FALSE
, FileFormTagsHead
, (EFI_IFR_DATA_ARRAY
*) CallbackData
);
1737 InitializeBinaryStructures (
1738 IN EFI_HII_HANDLE
*Handle
,
1739 IN BOOLEAN UseDatabase
,
1740 IN EFI_IFR_PACKET
*Packet
,
1741 IN UINT8
*NvMapOverride
,
1742 IN UINTN NumberOfIfrImages
,
1743 OUT EFI_FILE_FORM_TAGS
**FileFormTagsHead
1748 EFI_IFR_BINARY
*BinaryData
;
1749 EFI_FILE_FORM_TAGS
*FileFormTags
;
1750 UINTN SizeOfNvStore
;
1751 EFI_FORM_CALLBACK_PROTOCOL
*FormCallback
;
1752 EFI_VARIABLE_DEFINITION
*VariableDefinition
;
1753 EFI_VARIABLE_DEFINITION
*OverrideDefinition
;
1756 EFI_HII_VARIABLE_PACK_LIST
*NvMapListHead
;
1757 EFI_HII_VARIABLE_PACK_LIST
*NvMapListNode
;
1760 // Initialize some variables to avoid warnings
1763 *FileFormTagsHead
= NULL
;
1764 FileFormTags
= NULL
;
1765 gBinaryDataHead
= NULL
;
1766 Status
= EFI_SUCCESS
;
1767 FormCallback
= NULL
;
1771 if (NumberOfIfrImages
> 1) {
1772 NvMapOverride
= NULL
;
1775 for (HandleIndex
= 0; HandleIndex
< NumberOfIfrImages
; HandleIndex
+= 1) {
1777 // If the buffers are uninitialized, allocate them, otherwise work on the ->Next members
1779 if ((BinaryData
== NULL
) || (FileFormTags
== NULL
)) {
1781 // Allocate memory for our Binary Data
1783 BinaryData
= AllocateZeroPool (sizeof (EFI_IFR_BINARY
));
1784 ASSERT (BinaryData
);
1787 // Preserve the Head of what will be a linked-list.
1789 gBinaryDataHead
= BinaryData
;
1790 gBinaryDataHead
->Next
= NULL
;
1793 Status
= GetIfrBinaryData (Hii
, Handle
[HandleIndex
], NULL
, BinaryData
);
1795 Status
= GetIfrBinaryData (Hii
, Handle
[HandleIndex
], Packet
, BinaryData
);
1798 // Allocate memory for our File Form Tags
1800 FileFormTags
= AllocateZeroPool (sizeof (EFI_FILE_FORM_TAGS
));
1801 ASSERT (FileFormTags
);
1804 // Preserve the Head of what will be a linked-list.
1806 *FileFormTagsHead
= FileFormTags
;
1807 (*FileFormTagsHead
)->NextFile
= NULL
;
1811 // Allocate memory for our Binary Data linked-list
1812 // Each handle represents a Binary and we will store that data away.
1814 BinaryData
->Next
= AllocateZeroPool (sizeof (EFI_IFR_BINARY
));
1815 ASSERT (BinaryData
->Next
);
1817 BinaryData
= BinaryData
->Next
;
1818 BinaryData
->Next
= NULL
;
1821 Status
= GetIfrBinaryData (Hii
, Handle
[HandleIndex
], NULL
, BinaryData
);
1823 Status
= GetIfrBinaryData (Hii
, Handle
[HandleIndex
], Packet
, BinaryData
);
1826 if (EFI_ERROR (Status
)) {
1827 return EFI_DEVICE_ERROR
;
1830 // Allocate memory for our FileFormTags linked-list
1831 // Each allocation reserves handle represents a Binary and we will store that data away.
1833 FileFormTags
->NextFile
= AllocateZeroPool (sizeof (EFI_FILE_FORM_TAGS
));
1834 ASSERT (FileFormTags
->NextFile
);
1836 FileFormTags
= FileFormTags
->NextFile
;
1841 // Tag Structure Initialization
1843 Status
= InitializeTagStructures (BinaryData
, FileFormTags
);
1845 VariableDefinition
= FileFormTags
->VariableDefinitions
;
1848 // Allocate memory for our NVRAM Maps for all of our variables
1850 for (; VariableDefinition
!= NULL
; VariableDefinition
= VariableDefinition
->Next
) {
1852 // Pad the fake variable size accordingly - this value should reflect the size of information that is not accounted by
1853 // the mainstream NVRAM variable such as DATE/TIME information that the browser needs to track but is saved to an RTC
1855 VariableDefinition
->VariableFakeSize
= (UINT16
) (VariableDefinition
->VariableSize
+ VariableDefinition
->VariableFakeSize
);
1858 // In the case where a file has no "real" NV data, we should pad the buffer accordingly
1860 if (VariableDefinition
->VariableSize
== 0) {
1861 if (VariableDefinition
->VariableFakeSize
!= 0) {
1862 VariableDefinition
->NvRamMap
= AllocateZeroPool (VariableDefinition
->VariableFakeSize
);
1863 ASSERT (VariableDefinition
->NvRamMap
!= NULL
);
1866 VariableDefinition
->NvRamMap
= AllocateZeroPool (VariableDefinition
->VariableSize
);
1867 ASSERT (VariableDefinition
->NvRamMap
!= NULL
);
1870 if (VariableDefinition
->VariableFakeSize
!= 0) {
1871 VariableDefinition
->FakeNvRamMap
= AllocateZeroPool (VariableDefinition
->VariableFakeSize
);
1872 ASSERT (VariableDefinition
->FakeNvRamMap
!= NULL
);
1876 Status
= gBS
->HandleProtocol (
1877 (VOID
*) (UINTN
) FileFormTags
->FormTags
.Tags
[0].CallbackHandle
,
1878 &gEfiFormCallbackProtocolGuid
,
1879 (VOID
**) &FormCallback
1883 // Since we might have multiple variables, if there is an NvMapOverride we need to use the EFI_VARIABLE_DEFINITION
1884 // information as the information that we pass back and forth. NOTE that callbacks that are initiated will only have the
1885 // NVRAM data refreshed based on the op-code that initiated the callback. In other words, we will pass to the caller a single
1886 // NVRAM map for a single variable based on the op-code that the user selected.
1888 if (NvMapOverride
!= NULL
) {
1889 VariableDefinition
= FileFormTags
->VariableDefinitions
;
1890 OverrideDefinition
= ((EFI_VARIABLE_DEFINITION
*) NvMapOverride
);
1893 // Search through the variable definitions. There should be sufficient passed in settings for the variable op-codes specified
1895 for (; VariableDefinition
!= NULL
; VariableDefinition
= VariableDefinition
->Next
) {
1896 if ((!CompareMem (VariableDefinition
->VariableName
, L
"Setup", 10)) && (VariableDefinition
->Next
== NULL
)) {
1897 if (VariableDefinition
->VariableSize
!= 0) {
1898 CopyMem (VariableDefinition
->NvRamMap
, NvMapOverride
, VariableDefinition
->VariableSize
);
1900 CopyMem (VariableDefinition
->NvRamMap
, NvMapOverride
, VariableDefinition
->VariableFakeSize
);
1904 VariableDefinition
->NvRamMap
= OverrideDefinition
->NvRamMap
;
1907 // There should NEVER be a ->Next for VariableDefinition and a NULL ->Next for the OverrideDefinition
1909 ASSERT (OverrideDefinition
->Next
);
1910 OverrideDefinition
= OverrideDefinition
->Next
;
1913 VariableDefinition
= FileFormTags
->VariableDefinitions
;
1916 // Search through the variable definitions. There should be sufficient passed in settings for the variable op-codes specified
1918 for (; VariableDefinition
!= NULL
; VariableDefinition
= VariableDefinition
->Next
) {
1919 SizeOfNvStore
= VariableDefinition
->VariableSize
;
1922 // Getting the NvStore and placing it into our Global Data
1924 if ((FormCallback
!= NULL
) && (FormCallback
->NvRead
!= NULL
)) {
1925 Status
= FormCallback
->NvRead (
1927 VariableDefinition
->VariableName
,
1928 &VariableDefinition
->Guid
,
1931 (VOID
*) VariableDefinition
->NvRamMap
1934 Status
= gRT
->GetVariable (
1935 VariableDefinition
->VariableName
,
1936 &VariableDefinition
->Guid
,
1939 (VOID
*) VariableDefinition
->NvRamMap
1943 if (EFI_ERROR (Status
)) {
1945 // If there is a variable that exists already and it is larger than what we calculated the
1946 // storage needs to be, we must assume the variable size from GetVariable is correct and not
1947 // allow the truncation of the variable. It is very possible that the user who created the IFR
1948 // we are cracking is not referring to a variable that was in a previous map, however we cannot
1949 // allow it's truncation.
1951 if (Status
== EFI_BUFFER_TOO_SMALL
) {
1953 // If the buffer was too small, we should have the expanded size requirement in SizeOfNvStore now.
1955 VariableDefinition
->VariableSize
= (UINT16
) SizeOfNvStore
;
1958 // Free the buffer that was allocated that was too small
1960 FreePool (VariableDefinition
->NvRamMap
);
1961 FreePool (VariableDefinition
->FakeNvRamMap
);
1963 VariableDefinition
->NvRamMap
= AllocateZeroPool (SizeOfNvStore
);
1964 VariableDefinition
->FakeNvRamMap
= AllocateZeroPool (SizeOfNvStore
+ VariableDefinition
->VariableFakeSize
);
1965 ASSERT (VariableDefinition
->NvRamMap
);
1966 ASSERT (VariableDefinition
->FakeNvRamMap
);
1968 if ((FormCallback
!= NULL
) && (FormCallback
->NvRead
!= NULL
)) {
1969 Status
= FormCallback
->NvRead (
1971 VariableDefinition
->VariableName
,
1972 &VariableDefinition
->Guid
,
1975 (VOID
*) VariableDefinition
->NvRamMap
1978 Status
= gRT
->GetVariable (
1979 VariableDefinition
->VariableName
,
1980 &VariableDefinition
->Guid
,
1983 (VOID
*) VariableDefinition
->NvRamMap
1988 // if the variable was not found, we will retrieve default values
1990 if (Status
== EFI_NOT_FOUND
) {
1992 if (0 == CompareMem (VariableDefinition
->VariableName
, L
"Setup", 10)) {
1994 NvMapListHead
= NULL
;
1996 Status
= Hii
->GetDefaultImage (Hii
, Handle
[HandleIndex
], EFI_IFR_FLAG_DEFAULT
, &NvMapListHead
);
1998 if (!EFI_ERROR (Status
)) {
1999 ASSERT_EFI_ERROR (NULL
!= NvMapListHead
);
2001 NvMapListNode
= NvMapListHead
;
2003 while (NULL
!= NvMapListNode
) {
2004 if (VariableDefinition
->VariableId
== NvMapListNode
->VariablePack
->VariableId
) {
2005 NvMap
= (VOID
*) ((CHAR8
*) NvMapListNode
->VariablePack
+ sizeof (EFI_HII_VARIABLE_PACK
) + NvMapListNode
->VariablePack
->VariableNameLength
);
2006 NvMapSize
= NvMapListNode
->VariablePack
->Header
.Length
- sizeof (EFI_HII_VARIABLE_PACK
) - NvMapListNode
->VariablePack
->VariableNameLength
;
2009 NvMapListNode
= NvMapListNode
->NextVariablePack
;
2013 // Free the buffer that was allocated.
2015 FreePool (VariableDefinition
->NvRamMap
);
2016 FreePool (VariableDefinition
->FakeNvRamMap
);
2019 // Allocate, copy the NvRamMap.
2021 VariableDefinition
->VariableFakeSize
= (UINT16
) (VariableDefinition
->VariableFakeSize
- VariableDefinition
->VariableSize
);
2022 VariableDefinition
->VariableSize
= (UINT16
) NvMapSize
;
2023 VariableDefinition
->VariableFakeSize
= (UINT16
) (VariableDefinition
->VariableFakeSize
+ VariableDefinition
->VariableSize
);
2025 VariableDefinition
->NvRamMap
= AllocateZeroPool (VariableDefinition
->VariableSize
);
2026 VariableDefinition
->FakeNvRamMap
= AllocateZeroPool (NvMapSize
+ VariableDefinition
->VariableFakeSize
);
2028 CopyMem (VariableDefinition
->NvRamMap
, NvMap
, NvMapSize
);
2029 FreePool (NvMapListHead
);
2033 Status
= EFI_SUCCESS
;
2039 InitializeTagStructures (BinaryData
, FileFormTags
);
2050 IN EFI_HII_PROTOCOL
*Hii
,
2051 IN EFI_HII_HANDLE HiiHandle
,
2052 IN EFI_IFR_PACKET
*Packet
,
2053 IN OUT EFI_IFR_BINARY
*BinaryData
2057 Routine Description:
2058 Fetch the Ifr binary data.
2061 Hii - Point to HII protocol.
2062 HiiHandle - Handle of Ifr to be fetched.
2063 Packet - Pointer to IFR packet.
2064 BinaryData - Buffer to copy the string into
2067 Returns the number of CHAR16 characters that were copied into the OutputString buffer.
2073 EFI_HII_PACKAGES
*PackageList
;
2076 UINT8
*RawFormBinary
;
2077 EFI_IFR_FORM_SET
*FormOp
;
2083 // Initialize the TitleToken to 0 just in case not found
2088 // Try for a 32K Buffer
2090 BufferSize
= 0x8000;
2093 // Allocate memory for our Form binary
2095 Buffer
= AllocateZeroPool (BufferSize
);
2098 if (Packet
== NULL
) {
2099 Status
= Hii
->GetForms (Hii
, HiiHandle
, 0, &BufferSize
, Buffer
);
2101 if (Status
== EFI_BUFFER_TOO_SMALL
) {
2106 // Allocate memory for our Form binary
2108 Buffer
= AllocatePool (BufferSize
);
2111 Status
= Hii
->GetForms (Hii
, HiiHandle
, 0, &BufferSize
, Buffer
);
2115 // Copies the data to local usable buffer
2117 CopyMem (Buffer
, Packet
->IfrData
, Packet
->IfrData
->Header
.Length
);
2120 // Register the string data with HII
2122 PackageList
= PreparePackages (2, NULL
, Packet
->IfrData
, Packet
->StringData
);
2124 Status
= Hii
->NewPack (Hii
, PackageList
, &HiiHandle
);
2126 FreePool (PackageList
);
2129 if (EFI_ERROR (Status
)) {
2133 // We now have the IFR binary in our Buffer
2135 BinaryData
->IfrPackage
= Buffer
;
2136 RawFormBinary
= (UINT8
*) ((CHAR8
*) (Buffer
) + sizeof (EFI_HII_PACK_HEADER
));
2137 BinaryData
->FormBinary
= (UINT8
*) ((CHAR8
*) (Buffer
) + sizeof (EFI_HII_PACK_HEADER
));
2138 BinaryData
->Handle
= HiiHandle
;
2141 // If a packet was passed in, remove the string data when exiting.
2143 if (Packet
!= NULL
) {
2144 BinaryData
->UnRegisterOnExit
= TRUE
;
2146 BinaryData
->UnRegisterOnExit
= FALSE
;
2149 // Walk through the FormSet Opcodes looking for the FormSet opcode
2150 // If we hit EFI_IFR_END_SET_OP we know we hit the end of the FormSet.
2152 for (Index
= 0; RawFormBinary
[Index
] != EFI_IFR_END_FORM_SET_OP
;) {
2153 FormOp
= (EFI_IFR_FORM_SET
*) &RawFormBinary
[Index
];
2154 Index
= (UINT16
) (Index
+ FormOp
->Header
.Length
);
2156 if (FormOp
->Header
.OpCode
== EFI_IFR_FORM_SET_OP
) {
2157 TitleToken
= FormOp
->FormSetTitle
;
2159 // If displaying FrontPage - set the flag signifying it
2161 switch (FormOp
->SubClass
) {
2162 case EFI_FRONT_PAGE_SUBCLASS
:
2163 FrontPageHandle
= HiiHandle
;
2166 gClassOfVfr
= FormOp
->SubClass
;
2169 // Match GUID to find out the function key setting. If match fail, use the default setting.
2171 for (Index2
= 0; Index2
< sizeof (gFunctionKeySettingTable
) / sizeof (FUNCTIION_KEY_SETTING
); Index2
++) {
2172 if (CompareGuid ((EFI_GUID
*)(UINTN
)&FormOp
->Guid
, &(gFunctionKeySettingTable
[Index2
].FormSetGuid
))) {
2174 // Update the function key setting.
2176 gFunctionKeySetting
= gFunctionKeySettingTable
[Index2
].KeySetting
;
2178 // Function key prompt can not be displayed if the function key has been disabled.
2180 if ((gFunctionKeySetting
& FUNCTION_ONE
) != FUNCTION_ONE
) {
2181 gFunctionOneString
= GetToken (STRING_TOKEN (EMPTY_STRING
), gHiiHandle
);
2184 if ((gFunctionKeySetting
& FUNCTION_TWO
) != FUNCTION_TWO
) {
2185 gFunctionTwoString
= GetToken (STRING_TOKEN (EMPTY_STRING
), gHiiHandle
);
2188 if ((gFunctionKeySetting
& FUNCTION_NINE
) != FUNCTION_NINE
) {
2189 gFunctionNineString
= GetToken (STRING_TOKEN (EMPTY_STRING
), gHiiHandle
);
2192 if ((gFunctionKeySetting
& FUNCTION_TEN
) != FUNCTION_TEN
) {
2193 gFunctionTenString
= GetToken (STRING_TOKEN (EMPTY_STRING
), gHiiHandle
);
2200 BinaryData
->TitleToken
= TitleToken
;
2205 EFI_HANDLE PrintHandle
= NULL
;
2206 EFI_PRINT_PROTOCOL mPrintProtocol
= { UnicodeVSPrint
};
2214 return gBS
->InstallProtocolInterface (
2216 &gEfiPrintProtocolGuid
,
2217 EFI_NATIVE_INTERFACE
,