]> git.proxmox.com Git - mirror_edk2.git/blob - MdePkg/Include/Uefi/UefiInternalFormRepresentation.h
MdePkg: REST style formset
[mirror_edk2.git] / MdePkg / Include / Uefi / UefiInternalFormRepresentation.h
1 /** @file
2 This file defines the encoding for the VFR (Visual Form Representation) language.
3 IFR is primarily consumed by the EFI presentation engine, and produced by EFI
4 internal application and drivers as well as all add-in card option-ROM drivers
5
6 Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
7 (C) Copyright 2016 Hewlett Packard Enterprise Development LP<BR>
8 SPDX-License-Identifier: BSD-2-Clause-Patent
9
10 @par Revision Reference:
11 These definitions are from UEFI 2.1 and 2.2.
12
13 **/
14
15 #ifndef __UEFI_INTERNAL_FORMREPRESENTATION_H__
16 #define __UEFI_INTERNAL_FORMREPRESENTATION_H__
17
18 #include <Guid/HiiFormMapMethodGuid.h>
19
20 ///
21 /// The following types are currently defined:
22 ///
23 typedef VOID* EFI_HII_HANDLE;
24 typedef CHAR16* EFI_STRING;
25 typedef UINT16 EFI_IMAGE_ID;
26 typedef UINT16 EFI_QUESTION_ID;
27 typedef UINT16 EFI_STRING_ID;
28 typedef UINT16 EFI_FORM_ID;
29 typedef UINT16 EFI_VARSTORE_ID;
30 typedef UINT16 EFI_ANIMATION_ID;
31
32 typedef UINT16 EFI_DEFAULT_ID;
33
34 typedef UINT32 EFI_HII_FONT_STYLE;
35
36
37
38 #pragma pack(1)
39
40 //
41 // Definitions for Package Lists and Package Headers
42 // Section 27.3.1
43 //
44
45 ///
46 /// The header found at the start of each package list.
47 ///
48 typedef struct {
49 EFI_GUID PackageListGuid;
50 UINT32 PackageLength;
51 } EFI_HII_PACKAGE_LIST_HEADER;
52
53 ///
54 /// The header found at the start of each package.
55 ///
56 typedef struct {
57 UINT32 Length:24;
58 UINT32 Type:8;
59 // UINT8 Data[...];
60 } EFI_HII_PACKAGE_HEADER;
61
62 //
63 // Value of HII package type
64 //
65 #define EFI_HII_PACKAGE_TYPE_ALL 0x00
66 #define EFI_HII_PACKAGE_TYPE_GUID 0x01
67 #define EFI_HII_PACKAGE_FORMS 0x02
68 #define EFI_HII_PACKAGE_STRINGS 0x04
69 #define EFI_HII_PACKAGE_FONTS 0x05
70 #define EFI_HII_PACKAGE_IMAGES 0x06
71 #define EFI_HII_PACKAGE_SIMPLE_FONTS 0x07
72 #define EFI_HII_PACKAGE_DEVICE_PATH 0x08
73 #define EFI_HII_PACKAGE_KEYBOARD_LAYOUT 0x09
74 #define EFI_HII_PACKAGE_ANIMATIONS 0x0A
75 #define EFI_HII_PACKAGE_END 0xDF
76 #define EFI_HII_PACKAGE_TYPE_SYSTEM_BEGIN 0xE0
77 #define EFI_HII_PACKAGE_TYPE_SYSTEM_END 0xFF
78
79 //
80 // Definitions for Simplified Font Package
81 //
82
83 ///
84 /// Contents of EFI_NARROW_GLYPH.Attributes.
85 ///@{
86 #define EFI_GLYPH_NON_SPACING 0x01
87 #define EFI_GLYPH_WIDE 0x02
88 #define EFI_GLYPH_HEIGHT 19
89 #define EFI_GLYPH_WIDTH 8
90 ///@}
91
92 ///
93 /// The EFI_NARROW_GLYPH has a preferred dimension (w x h) of 8 x 19 pixels.
94 ///
95 typedef struct {
96 ///
97 /// The Unicode representation of the glyph. The term weight is the
98 /// technical term for a character code.
99 ///
100 CHAR16 UnicodeWeight;
101 ///
102 /// The data element containing the glyph definitions.
103 ///
104 UINT8 Attributes;
105 ///
106 /// The column major glyph representation of the character. Bits
107 /// with values of one indicate that the corresponding pixel is to be
108 /// on when normally displayed; those with zero are off.
109 ///
110 UINT8 GlyphCol1[EFI_GLYPH_HEIGHT];
111 } EFI_NARROW_GLYPH;
112
113 ///
114 /// The EFI_WIDE_GLYPH has a preferred dimension (w x h) of 16 x 19 pixels, which is large enough
115 /// to accommodate logographic characters.
116 ///
117 typedef struct {
118 ///
119 /// The Unicode representation of the glyph. The term weight is the
120 /// technical term for a character code.
121 ///
122 CHAR16 UnicodeWeight;
123 ///
124 /// The data element containing the glyph definitions.
125 ///
126 UINT8 Attributes;
127 ///
128 /// The column major glyph representation of the character. Bits
129 /// with values of one indicate that the corresponding pixel is to be
130 /// on when normally displayed; those with zero are off.
131 ///
132 UINT8 GlyphCol1[EFI_GLYPH_HEIGHT];
133 ///
134 /// The column major glyph representation of the character. Bits
135 /// with values of one indicate that the corresponding pixel is to be
136 /// on when normally displayed; those with zero are off.
137 ///
138 UINT8 GlyphCol2[EFI_GLYPH_HEIGHT];
139 ///
140 /// Ensures that sizeof (EFI_WIDE_GLYPH) is twice the
141 /// sizeof (EFI_NARROW_GLYPH). The contents of Pad must
142 /// be zero.
143 ///
144 UINT8 Pad[3];
145 } EFI_WIDE_GLYPH;
146
147 ///
148 /// A simplified font package consists of a font header
149 /// followed by a series of glyph structures.
150 ///
151 typedef struct _EFI_HII_SIMPLE_FONT_PACKAGE_HDR {
152 EFI_HII_PACKAGE_HEADER Header;
153 UINT16 NumberOfNarrowGlyphs;
154 UINT16 NumberOfWideGlyphs;
155 // EFI_NARROW_GLYPH NarrowGlyphs[];
156 // EFI_WIDE_GLYPH WideGlyphs[];
157 } EFI_HII_SIMPLE_FONT_PACKAGE_HDR;
158
159 //
160 // Definitions for Font Package
161 // Section 27.3.3
162 //
163
164 //
165 // Value for font style
166 //
167 #define EFI_HII_FONT_STYLE_NORMAL 0x00000000
168 #define EFI_HII_FONT_STYLE_BOLD 0x00000001
169 #define EFI_HII_FONT_STYLE_ITALIC 0x00000002
170 #define EFI_HII_FONT_STYLE_EMBOSS 0x00010000
171 #define EFI_HII_FONT_STYLE_OUTLINE 0x00020000
172 #define EFI_HII_FONT_STYLE_SHADOW 0x00040000
173 #define EFI_HII_FONT_STYLE_UNDERLINE 0x00080000
174 #define EFI_HII_FONT_STYLE_DBL_UNDER 0x00100000
175
176 typedef struct _EFI_HII_GLYPH_INFO {
177 UINT16 Width;
178 UINT16 Height;
179 INT16 OffsetX;
180 INT16 OffsetY;
181 INT16 AdvanceX;
182 } EFI_HII_GLYPH_INFO;
183
184 ///
185 /// The fixed header consists of a standard record header,
186 /// then the character values in this section, the flags
187 /// (including the encoding method) and the offsets of the glyph
188 /// information, the glyph bitmaps and the character map.
189 ///
190 typedef struct _EFI_HII_FONT_PACKAGE_HDR {
191 EFI_HII_PACKAGE_HEADER Header;
192 UINT32 HdrSize;
193 UINT32 GlyphBlockOffset;
194 EFI_HII_GLYPH_INFO Cell;
195 EFI_HII_FONT_STYLE FontStyle;
196 CHAR16 FontFamily[1];
197 } EFI_HII_FONT_PACKAGE_HDR;
198
199 //
200 // Value of different glyph info block types
201 //
202 #define EFI_HII_GIBT_END 0x00
203 #define EFI_HII_GIBT_GLYPH 0x10
204 #define EFI_HII_GIBT_GLYPHS 0x11
205 #define EFI_HII_GIBT_GLYPH_DEFAULT 0x12
206 #define EFI_HII_GIBT_GLYPHS_DEFAULT 0x13
207 #define EFI_HII_GIBT_GLYPH_VARIABILITY 0x14
208 #define EFI_HII_GIBT_DUPLICATE 0x20
209 #define EFI_HII_GIBT_SKIP2 0x21
210 #define EFI_HII_GIBT_SKIP1 0x22
211 #define EFI_HII_GIBT_DEFAULTS 0x23
212 #define EFI_HII_GIBT_EXT1 0x30
213 #define EFI_HII_GIBT_EXT2 0x31
214 #define EFI_HII_GIBT_EXT4 0x32
215
216 typedef struct _EFI_HII_GLYPH_BLOCK {
217 UINT8 BlockType;
218 } EFI_HII_GLYPH_BLOCK;
219
220 //
221 // Definition of different glyph info block types
222 //
223
224 typedef struct _EFI_HII_GIBT_DEFAULTS_BLOCK {
225 EFI_HII_GLYPH_BLOCK Header;
226 EFI_HII_GLYPH_INFO Cell;
227 } EFI_HII_GIBT_DEFAULTS_BLOCK;
228
229 typedef struct _EFI_HII_GIBT_DUPLICATE_BLOCK {
230 EFI_HII_GLYPH_BLOCK Header;
231 CHAR16 CharValue;
232 } EFI_HII_GIBT_DUPLICATE_BLOCK;
233
234 typedef struct _EFI_GLYPH_GIBT_END_BLOCK {
235 EFI_HII_GLYPH_BLOCK Header;
236 } EFI_GLYPH_GIBT_END_BLOCK;
237
238 typedef struct _EFI_HII_GIBT_EXT1_BLOCK {
239 EFI_HII_GLYPH_BLOCK Header;
240 UINT8 BlockType2;
241 UINT8 Length;
242 } EFI_HII_GIBT_EXT1_BLOCK;
243
244 typedef struct _EFI_HII_GIBT_EXT2_BLOCK {
245 EFI_HII_GLYPH_BLOCK Header;
246 UINT8 BlockType2;
247 UINT16 Length;
248 } EFI_HII_GIBT_EXT2_BLOCK;
249
250 typedef struct _EFI_HII_GIBT_EXT4_BLOCK {
251 EFI_HII_GLYPH_BLOCK Header;
252 UINT8 BlockType2;
253 UINT32 Length;
254 } EFI_HII_GIBT_EXT4_BLOCK;
255
256 typedef struct _EFI_HII_GIBT_GLYPH_BLOCK {
257 EFI_HII_GLYPH_BLOCK Header;
258 EFI_HII_GLYPH_INFO Cell;
259 UINT8 BitmapData[1];
260 } EFI_HII_GIBT_GLYPH_BLOCK;
261
262 typedef struct _EFI_HII_GIBT_GLYPHS_BLOCK {
263 EFI_HII_GLYPH_BLOCK Header;
264 EFI_HII_GLYPH_INFO Cell;
265 UINT16 Count;
266 UINT8 BitmapData[1];
267 } EFI_HII_GIBT_GLYPHS_BLOCK;
268
269 typedef struct _EFI_HII_GIBT_GLYPH_DEFAULT_BLOCK {
270 EFI_HII_GLYPH_BLOCK Header;
271 UINT8 BitmapData[1];
272 } EFI_HII_GIBT_GLYPH_DEFAULT_BLOCK;
273
274 typedef struct _EFI_HII_GIBT_GLYPHS_DEFAULT_BLOCK {
275 EFI_HII_GLYPH_BLOCK Header;
276 UINT16 Count;
277 UINT8 BitmapData[1];
278 } EFI_HII_GIBT_GLYPHS_DEFAULT_BLOCK;
279
280 typedef struct _EFI_HII_GIBT_VARIABILITY_BLOCK {
281 EFI_HII_GLYPH_BLOCK Header;
282 EFI_HII_GLYPH_INFO Cell;
283 UINT8 GlyphPackInBits;
284 UINT8 BitmapData [1];
285 } EFI_HII_GIBT_VARIABILITY_BLOCK;
286
287 typedef struct _EFI_HII_GIBT_SKIP1_BLOCK {
288 EFI_HII_GLYPH_BLOCK Header;
289 UINT8 SkipCount;
290 } EFI_HII_GIBT_SKIP1_BLOCK;
291
292 typedef struct _EFI_HII_GIBT_SKIP2_BLOCK {
293 EFI_HII_GLYPH_BLOCK Header;
294 UINT16 SkipCount;
295 } EFI_HII_GIBT_SKIP2_BLOCK;
296
297 //
298 // Definitions for Device Path Package
299 // Section 27.3.4
300 //
301
302 ///
303 /// The device path package is used to carry a device path
304 /// associated with the package list.
305 ///
306 typedef struct _EFI_HII_DEVICE_PATH_PACKAGE_HDR {
307 EFI_HII_PACKAGE_HEADER Header;
308 // EFI_DEVICE_PATH_PROTOCOL DevicePath[];
309 } EFI_HII_DEVICE_PATH_PACKAGE_HDR;
310
311 //
312 // Definitions for GUID Package
313 // Section 27.3.5
314 //
315
316 ///
317 /// The GUID package is used to carry data where the format is defined by a GUID.
318 ///
319 typedef struct _EFI_HII_GUID_PACKAGE_HDR {
320 EFI_HII_PACKAGE_HEADER Header;
321 EFI_GUID Guid;
322 // Data per GUID definition may follow
323 } EFI_HII_GUID_PACKAGE_HDR;
324
325 //
326 // Definitions for String Package
327 // Section 27.3.6
328 //
329
330 #define UEFI_CONFIG_LANG "x-UEFI"
331 #define UEFI_CONFIG_LANG_2 "x-i-UEFI"
332
333 ///
334 /// The fixed header consists of a standard record header and then the string identifiers
335 /// contained in this section and the offsets of the string and language information.
336 ///
337 typedef struct _EFI_HII_STRING_PACKAGE_HDR {
338 EFI_HII_PACKAGE_HEADER Header;
339 UINT32 HdrSize;
340 UINT32 StringInfoOffset;
341 CHAR16 LanguageWindow[16];
342 EFI_STRING_ID LanguageName;
343 CHAR8 Language[1];
344 } EFI_HII_STRING_PACKAGE_HDR;
345
346 typedef struct {
347 UINT8 BlockType;
348 } EFI_HII_STRING_BLOCK;
349
350 //
351 // Value of different string information block types
352 //
353 #define EFI_HII_SIBT_END 0x00
354 #define EFI_HII_SIBT_STRING_SCSU 0x10
355 #define EFI_HII_SIBT_STRING_SCSU_FONT 0x11
356 #define EFI_HII_SIBT_STRINGS_SCSU 0x12
357 #define EFI_HII_SIBT_STRINGS_SCSU_FONT 0x13
358 #define EFI_HII_SIBT_STRING_UCS2 0x14
359 #define EFI_HII_SIBT_STRING_UCS2_FONT 0x15
360 #define EFI_HII_SIBT_STRINGS_UCS2 0x16
361 #define EFI_HII_SIBT_STRINGS_UCS2_FONT 0x17
362 #define EFI_HII_SIBT_DUPLICATE 0x20
363 #define EFI_HII_SIBT_SKIP2 0x21
364 #define EFI_HII_SIBT_SKIP1 0x22
365 #define EFI_HII_SIBT_EXT1 0x30
366 #define EFI_HII_SIBT_EXT2 0x31
367 #define EFI_HII_SIBT_EXT4 0x32
368 #define EFI_HII_SIBT_FONT 0x40
369
370 //
371 // Definition of different string information block types
372 //
373
374 typedef struct _EFI_HII_SIBT_DUPLICATE_BLOCK {
375 EFI_HII_STRING_BLOCK Header;
376 EFI_STRING_ID StringId;
377 } EFI_HII_SIBT_DUPLICATE_BLOCK;
378
379 typedef struct _EFI_HII_SIBT_END_BLOCK {
380 EFI_HII_STRING_BLOCK Header;
381 } EFI_HII_SIBT_END_BLOCK;
382
383 typedef struct _EFI_HII_SIBT_EXT1_BLOCK {
384 EFI_HII_STRING_BLOCK Header;
385 UINT8 BlockType2;
386 UINT8 Length;
387 } EFI_HII_SIBT_EXT1_BLOCK;
388
389 typedef struct _EFI_HII_SIBT_EXT2_BLOCK {
390 EFI_HII_STRING_BLOCK Header;
391 UINT8 BlockType2;
392 UINT16 Length;
393 } EFI_HII_SIBT_EXT2_BLOCK;
394
395 typedef struct _EFI_HII_SIBT_EXT4_BLOCK {
396 EFI_HII_STRING_BLOCK Header;
397 UINT8 BlockType2;
398 UINT32 Length;
399 } EFI_HII_SIBT_EXT4_BLOCK;
400
401 typedef struct _EFI_HII_SIBT_FONT_BLOCK {
402 EFI_HII_SIBT_EXT2_BLOCK Header;
403 UINT8 FontId;
404 UINT16 FontSize;
405 EFI_HII_FONT_STYLE FontStyle;
406 CHAR16 FontName[1];
407 } EFI_HII_SIBT_FONT_BLOCK;
408
409 typedef struct _EFI_HII_SIBT_SKIP1_BLOCK {
410 EFI_HII_STRING_BLOCK Header;
411 UINT8 SkipCount;
412 } EFI_HII_SIBT_SKIP1_BLOCK;
413
414 typedef struct _EFI_HII_SIBT_SKIP2_BLOCK {
415 EFI_HII_STRING_BLOCK Header;
416 UINT16 SkipCount;
417 } EFI_HII_SIBT_SKIP2_BLOCK;
418
419 typedef struct _EFI_HII_SIBT_STRING_SCSU_BLOCK {
420 EFI_HII_STRING_BLOCK Header;
421 UINT8 StringText[1];
422 } EFI_HII_SIBT_STRING_SCSU_BLOCK;
423
424 typedef struct _EFI_HII_SIBT_STRING_SCSU_FONT_BLOCK {
425 EFI_HII_STRING_BLOCK Header;
426 UINT8 FontIdentifier;
427 UINT8 StringText[1];
428 } EFI_HII_SIBT_STRING_SCSU_FONT_BLOCK;
429
430 typedef struct _EFI_HII_SIBT_STRINGS_SCSU_BLOCK {
431 EFI_HII_STRING_BLOCK Header;
432 UINT16 StringCount;
433 UINT8 StringText[1];
434 } EFI_HII_SIBT_STRINGS_SCSU_BLOCK;
435
436 typedef struct _EFI_HII_SIBT_STRINGS_SCSU_FONT_BLOCK {
437 EFI_HII_STRING_BLOCK Header;
438 UINT8 FontIdentifier;
439 UINT16 StringCount;
440 UINT8 StringText[1];
441 } EFI_HII_SIBT_STRINGS_SCSU_FONT_BLOCK;
442
443 typedef struct _EFI_HII_SIBT_STRING_UCS2_BLOCK {
444 EFI_HII_STRING_BLOCK Header;
445 CHAR16 StringText[1];
446 } EFI_HII_SIBT_STRING_UCS2_BLOCK;
447
448 typedef struct _EFI_HII_SIBT_STRING_UCS2_FONT_BLOCK {
449 EFI_HII_STRING_BLOCK Header;
450 UINT8 FontIdentifier;
451 CHAR16 StringText[1];
452 } EFI_HII_SIBT_STRING_UCS2_FONT_BLOCK;
453
454 typedef struct _EFI_HII_SIBT_STRINGS_UCS2_BLOCK {
455 EFI_HII_STRING_BLOCK Header;
456 UINT16 StringCount;
457 CHAR16 StringText[1];
458 } EFI_HII_SIBT_STRINGS_UCS2_BLOCK;
459
460 typedef struct _EFI_HII_SIBT_STRINGS_UCS2_FONT_BLOCK {
461 EFI_HII_STRING_BLOCK Header;
462 UINT8 FontIdentifier;
463 UINT16 StringCount;
464 CHAR16 StringText[1];
465 } EFI_HII_SIBT_STRINGS_UCS2_FONT_BLOCK;
466
467 //
468 // Definitions for Image Package
469 // Section 27.3.7
470 //
471
472 typedef struct _EFI_HII_IMAGE_PACKAGE_HDR {
473 EFI_HII_PACKAGE_HEADER Header;
474 UINT32 ImageInfoOffset;
475 UINT32 PaletteInfoOffset;
476 } EFI_HII_IMAGE_PACKAGE_HDR;
477
478 typedef struct _EFI_HII_IMAGE_BLOCK {
479 UINT8 BlockType;
480 } EFI_HII_IMAGE_BLOCK;
481
482 //
483 // Value of different image information block types
484 //
485 #define EFI_HII_IIBT_END 0x00
486 #define EFI_HII_IIBT_IMAGE_1BIT 0x10
487 #define EFI_HII_IIBT_IMAGE_1BIT_TRANS 0x11
488 #define EFI_HII_IIBT_IMAGE_4BIT 0x12
489 #define EFI_HII_IIBT_IMAGE_4BIT_TRANS 0x13
490 #define EFI_HII_IIBT_IMAGE_8BIT 0x14
491 #define EFI_HII_IIBT_IMAGE_8BIT_TRANS 0x15
492 #define EFI_HII_IIBT_IMAGE_24BIT 0x16
493 #define EFI_HII_IIBT_IMAGE_24BIT_TRANS 0x17
494 #define EFI_HII_IIBT_IMAGE_JPEG 0x18
495 #define EFI_HII_IIBT_IMAGE_PNG 0x19
496 #define EFI_HII_IIBT_DUPLICATE 0x20
497 #define EFI_HII_IIBT_SKIP2 0x21
498 #define EFI_HII_IIBT_SKIP1 0x22
499 #define EFI_HII_IIBT_EXT1 0x30
500 #define EFI_HII_IIBT_EXT2 0x31
501 #define EFI_HII_IIBT_EXT4 0x32
502
503 //
504 // Definition of different image information block types
505 //
506
507 typedef struct _EFI_HII_IIBT_END_BLOCK {
508 EFI_HII_IMAGE_BLOCK Header;
509 } EFI_HII_IIBT_END_BLOCK;
510
511 typedef struct _EFI_HII_IIBT_EXT1_BLOCK {
512 EFI_HII_IMAGE_BLOCK Header;
513 UINT8 BlockType2;
514 UINT8 Length;
515 } EFI_HII_IIBT_EXT1_BLOCK;
516
517 typedef struct _EFI_HII_IIBT_EXT2_BLOCK {
518 EFI_HII_IMAGE_BLOCK Header;
519 UINT8 BlockType2;
520 UINT16 Length;
521 } EFI_HII_IIBT_EXT2_BLOCK;
522
523 typedef struct _EFI_HII_IIBT_EXT4_BLOCK {
524 EFI_HII_IMAGE_BLOCK Header;
525 UINT8 BlockType2;
526 UINT32 Length;
527 } EFI_HII_IIBT_EXT4_BLOCK;
528
529 typedef struct _EFI_HII_IIBT_IMAGE_1BIT_BASE {
530 UINT16 Width;
531 UINT16 Height;
532 UINT8 Data[1];
533 } EFI_HII_IIBT_IMAGE_1BIT_BASE;
534
535 typedef struct _EFI_HII_IIBT_IMAGE_1BIT_BLOCK {
536 EFI_HII_IMAGE_BLOCK Header;
537 UINT8 PaletteIndex;
538 EFI_HII_IIBT_IMAGE_1BIT_BASE Bitmap;
539 } EFI_HII_IIBT_IMAGE_1BIT_BLOCK;
540
541 typedef struct _EFI_HII_IIBT_IMAGE_1BIT_TRANS_BLOCK {
542 EFI_HII_IMAGE_BLOCK Header;
543 UINT8 PaletteIndex;
544 EFI_HII_IIBT_IMAGE_1BIT_BASE Bitmap;
545 } EFI_HII_IIBT_IMAGE_1BIT_TRANS_BLOCK;
546
547 typedef struct _EFI_HII_RGB_PIXEL {
548 UINT8 b;
549 UINT8 g;
550 UINT8 r;
551 } EFI_HII_RGB_PIXEL;
552
553 typedef struct _EFI_HII_IIBT_IMAGE_24BIT_BASE {
554 UINT16 Width;
555 UINT16 Height;
556 EFI_HII_RGB_PIXEL Bitmap[1];
557 } EFI_HII_IIBT_IMAGE_24BIT_BASE;
558
559 typedef struct _EFI_HII_IIBT_IMAGE_24BIT_BLOCK {
560 EFI_HII_IMAGE_BLOCK Header;
561 EFI_HII_IIBT_IMAGE_24BIT_BASE Bitmap;
562 } EFI_HII_IIBT_IMAGE_24BIT_BLOCK;
563
564 typedef struct _EFI_HII_IIBT_IMAGE_24BIT_TRANS_BLOCK {
565 EFI_HII_IMAGE_BLOCK Header;
566 EFI_HII_IIBT_IMAGE_24BIT_BASE Bitmap;
567 } EFI_HII_IIBT_IMAGE_24BIT_TRANS_BLOCK;
568
569 typedef struct _EFI_HII_IIBT_IMAGE_4BIT_BASE {
570 UINT16 Width;
571 UINT16 Height;
572 UINT8 Data[1];
573 } EFI_HII_IIBT_IMAGE_4BIT_BASE;
574
575 typedef struct _EFI_HII_IIBT_IMAGE_4BIT_BLOCK {
576 EFI_HII_IMAGE_BLOCK Header;
577 UINT8 PaletteIndex;
578 EFI_HII_IIBT_IMAGE_4BIT_BASE Bitmap;
579 } EFI_HII_IIBT_IMAGE_4BIT_BLOCK;
580
581 typedef struct _EFI_HII_IIBT_IMAGE_4BIT_TRANS_BLOCK {
582 EFI_HII_IMAGE_BLOCK Header;
583 UINT8 PaletteIndex;
584 EFI_HII_IIBT_IMAGE_4BIT_BASE Bitmap;
585 } EFI_HII_IIBT_IMAGE_4BIT_TRANS_BLOCK;
586
587 typedef struct _EFI_HII_IIBT_IMAGE_8BIT_BASE {
588 UINT16 Width;
589 UINT16 Height;
590 UINT8 Data[1];
591 } EFI_HII_IIBT_IMAGE_8BIT_BASE;
592
593 typedef struct _EFI_HII_IIBT_IMAGE_8BIT_PALETTE_BLOCK {
594 EFI_HII_IMAGE_BLOCK Header;
595 UINT8 PaletteIndex;
596 EFI_HII_IIBT_IMAGE_8BIT_BASE Bitmap;
597 } EFI_HII_IIBT_IMAGE_8BIT_BLOCK;
598
599 typedef struct _EFI_HII_IIBT_IMAGE_8BIT_TRANS_BLOCK {
600 EFI_HII_IMAGE_BLOCK Header;
601 UINT8 PaletteIndex;
602 EFI_HII_IIBT_IMAGE_8BIT_BASE Bitmap;
603 } EFI_HII_IIBT_IMAGE_8BIT_TRAN_BLOCK;
604
605 typedef struct _EFI_HII_IIBT_DUPLICATE_BLOCK {
606 EFI_HII_IMAGE_BLOCK Header;
607 EFI_IMAGE_ID ImageId;
608 } EFI_HII_IIBT_DUPLICATE_BLOCK;
609
610 typedef struct _EFI_HII_IIBT_JPEG_BLOCK {
611 EFI_HII_IMAGE_BLOCK Header;
612 UINT32 Size;
613 UINT8 Data[1];
614 } EFI_HII_IIBT_JPEG_BLOCK;
615
616 typedef struct _EFI_HII_IIBT_PNG_BLOCK {
617 EFI_HII_IMAGE_BLOCK Header;
618 UINT32 Size;
619 UINT8 Data[1];
620 } EFI_HII_IIBT_PNG_BLOCK;
621
622 typedef struct _EFI_HII_IIBT_SKIP1_BLOCK {
623 EFI_HII_IMAGE_BLOCK Header;
624 UINT8 SkipCount;
625 } EFI_HII_IIBT_SKIP1_BLOCK;
626
627 typedef struct _EFI_HII_IIBT_SKIP2_BLOCK {
628 EFI_HII_IMAGE_BLOCK Header;
629 UINT16 SkipCount;
630 } EFI_HII_IIBT_SKIP2_BLOCK;
631
632 //
633 // Definitions for Palette Information
634 //
635
636 typedef struct _EFI_HII_IMAGE_PALETTE_INFO_HEADER {
637 UINT16 PaletteCount;
638 } EFI_HII_IMAGE_PALETTE_INFO_HEADER;
639
640 typedef struct _EFI_HII_IMAGE_PALETTE_INFO {
641 UINT16 PaletteSize;
642 EFI_HII_RGB_PIXEL PaletteValue[1];
643 } EFI_HII_IMAGE_PALETTE_INFO;
644
645 //
646 // Definitions for Forms Package
647 // Section 27.3.8
648 //
649
650 ///
651 /// The Form package is used to carry form-based encoding data.
652 ///
653 typedef struct _EFI_HII_FORM_PACKAGE_HDR {
654 EFI_HII_PACKAGE_HEADER Header;
655 // EFI_IFR_OP_HEADER OpCodeHeader;
656 // More op-codes follow
657 } EFI_HII_FORM_PACKAGE_HDR;
658
659 typedef struct {
660 UINT8 Hour;
661 UINT8 Minute;
662 UINT8 Second;
663 } EFI_HII_TIME;
664
665 typedef struct {
666 UINT16 Year;
667 UINT8 Month;
668 UINT8 Day;
669 } EFI_HII_DATE;
670
671 typedef struct {
672 EFI_QUESTION_ID QuestionId;
673 EFI_FORM_ID FormId;
674 EFI_GUID FormSetGuid;
675 EFI_STRING_ID DevicePath;
676 } EFI_HII_REF;
677
678 typedef union {
679 UINT8 u8;
680 UINT16 u16;
681 UINT32 u32;
682 UINT64 u64;
683 BOOLEAN b;
684 EFI_HII_TIME time;
685 EFI_HII_DATE date;
686 EFI_STRING_ID string; ///< EFI_IFR_TYPE_STRING, EFI_IFR_TYPE_ACTION
687 EFI_HII_REF ref; ///< EFI_IFR_TYPE_REF
688 // UINT8 buffer[]; ///< EFI_IFR_TYPE_BUFFER
689 } EFI_IFR_TYPE_VALUE;
690
691 //
692 // IFR Opcodes
693 //
694 #define EFI_IFR_FORM_OP 0x01
695 #define EFI_IFR_SUBTITLE_OP 0x02
696 #define EFI_IFR_TEXT_OP 0x03
697 #define EFI_IFR_IMAGE_OP 0x04
698 #define EFI_IFR_ONE_OF_OP 0x05
699 #define EFI_IFR_CHECKBOX_OP 0x06
700 #define EFI_IFR_NUMERIC_OP 0x07
701 #define EFI_IFR_PASSWORD_OP 0x08
702 #define EFI_IFR_ONE_OF_OPTION_OP 0x09
703 #define EFI_IFR_SUPPRESS_IF_OP 0x0A
704 #define EFI_IFR_LOCKED_OP 0x0B
705 #define EFI_IFR_ACTION_OP 0x0C
706 #define EFI_IFR_RESET_BUTTON_OP 0x0D
707 #define EFI_IFR_FORM_SET_OP 0x0E
708 #define EFI_IFR_REF_OP 0x0F
709 #define EFI_IFR_NO_SUBMIT_IF_OP 0x10
710 #define EFI_IFR_INCONSISTENT_IF_OP 0x11
711 #define EFI_IFR_EQ_ID_VAL_OP 0x12
712 #define EFI_IFR_EQ_ID_ID_OP 0x13
713 #define EFI_IFR_EQ_ID_VAL_LIST_OP 0x14
714 #define EFI_IFR_AND_OP 0x15
715 #define EFI_IFR_OR_OP 0x16
716 #define EFI_IFR_NOT_OP 0x17
717 #define EFI_IFR_RULE_OP 0x18
718 #define EFI_IFR_GRAY_OUT_IF_OP 0x19
719 #define EFI_IFR_DATE_OP 0x1A
720 #define EFI_IFR_TIME_OP 0x1B
721 #define EFI_IFR_STRING_OP 0x1C
722 #define EFI_IFR_REFRESH_OP 0x1D
723 #define EFI_IFR_DISABLE_IF_OP 0x1E
724 #define EFI_IFR_ANIMATION_OP 0x1F
725 #define EFI_IFR_TO_LOWER_OP 0x20
726 #define EFI_IFR_TO_UPPER_OP 0x21
727 #define EFI_IFR_MAP_OP 0x22
728 #define EFI_IFR_ORDERED_LIST_OP 0x23
729 #define EFI_IFR_VARSTORE_OP 0x24
730 #define EFI_IFR_VARSTORE_NAME_VALUE_OP 0x25
731 #define EFI_IFR_VARSTORE_EFI_OP 0x26
732 #define EFI_IFR_VARSTORE_DEVICE_OP 0x27
733 #define EFI_IFR_VERSION_OP 0x28
734 #define EFI_IFR_END_OP 0x29
735 #define EFI_IFR_MATCH_OP 0x2A
736 #define EFI_IFR_GET_OP 0x2B
737 #define EFI_IFR_SET_OP 0x2C
738 #define EFI_IFR_READ_OP 0x2D
739 #define EFI_IFR_WRITE_OP 0x2E
740 #define EFI_IFR_EQUAL_OP 0x2F
741 #define EFI_IFR_NOT_EQUAL_OP 0x30
742 #define EFI_IFR_GREATER_THAN_OP 0x31
743 #define EFI_IFR_GREATER_EQUAL_OP 0x32
744 #define EFI_IFR_LESS_THAN_OP 0x33
745 #define EFI_IFR_LESS_EQUAL_OP 0x34
746 #define EFI_IFR_BITWISE_AND_OP 0x35
747 #define EFI_IFR_BITWISE_OR_OP 0x36
748 #define EFI_IFR_BITWISE_NOT_OP 0x37
749 #define EFI_IFR_SHIFT_LEFT_OP 0x38
750 #define EFI_IFR_SHIFT_RIGHT_OP 0x39
751 #define EFI_IFR_ADD_OP 0x3A
752 #define EFI_IFR_SUBTRACT_OP 0x3B
753 #define EFI_IFR_MULTIPLY_OP 0x3C
754 #define EFI_IFR_DIVIDE_OP 0x3D
755 #define EFI_IFR_MODULO_OP 0x3E
756 #define EFI_IFR_RULE_REF_OP 0x3F
757 #define EFI_IFR_QUESTION_REF1_OP 0x40
758 #define EFI_IFR_QUESTION_REF2_OP 0x41
759 #define EFI_IFR_UINT8_OP 0x42
760 #define EFI_IFR_UINT16_OP 0x43
761 #define EFI_IFR_UINT32_OP 0x44
762 #define EFI_IFR_UINT64_OP 0x45
763 #define EFI_IFR_TRUE_OP 0x46
764 #define EFI_IFR_FALSE_OP 0x47
765 #define EFI_IFR_TO_UINT_OP 0x48
766 #define EFI_IFR_TO_STRING_OP 0x49
767 #define EFI_IFR_TO_BOOLEAN_OP 0x4A
768 #define EFI_IFR_MID_OP 0x4B
769 #define EFI_IFR_FIND_OP 0x4C
770 #define EFI_IFR_TOKEN_OP 0x4D
771 #define EFI_IFR_STRING_REF1_OP 0x4E
772 #define EFI_IFR_STRING_REF2_OP 0x4F
773 #define EFI_IFR_CONDITIONAL_OP 0x50
774 #define EFI_IFR_QUESTION_REF3_OP 0x51
775 #define EFI_IFR_ZERO_OP 0x52
776 #define EFI_IFR_ONE_OP 0x53
777 #define EFI_IFR_ONES_OP 0x54
778 #define EFI_IFR_UNDEFINED_OP 0x55
779 #define EFI_IFR_LENGTH_OP 0x56
780 #define EFI_IFR_DUP_OP 0x57
781 #define EFI_IFR_THIS_OP 0x58
782 #define EFI_IFR_SPAN_OP 0x59
783 #define EFI_IFR_VALUE_OP 0x5A
784 #define EFI_IFR_DEFAULT_OP 0x5B
785 #define EFI_IFR_DEFAULTSTORE_OP 0x5C
786 #define EFI_IFR_FORM_MAP_OP 0x5D
787 #define EFI_IFR_CATENATE_OP 0x5E
788 #define EFI_IFR_GUID_OP 0x5F
789 #define EFI_IFR_SECURITY_OP 0x60
790 #define EFI_IFR_MODAL_TAG_OP 0x61
791 #define EFI_IFR_REFRESH_ID_OP 0x62
792 #define EFI_IFR_WARNING_IF_OP 0x63
793 #define EFI_IFR_MATCH2_OP 0x64
794
795 //
796 // Definitions of IFR Standard Headers
797 // Section 27.3.8.2
798 //
799
800 typedef struct _EFI_IFR_OP_HEADER {
801 UINT8 OpCode;
802 UINT8 Length:7;
803 UINT8 Scope:1;
804 } EFI_IFR_OP_HEADER;
805
806 typedef struct _EFI_IFR_STATEMENT_HEADER {
807 EFI_STRING_ID Prompt;
808 EFI_STRING_ID Help;
809 } EFI_IFR_STATEMENT_HEADER;
810
811 typedef struct _EFI_IFR_QUESTION_HEADER {
812 EFI_IFR_STATEMENT_HEADER Header;
813 EFI_QUESTION_ID QuestionId;
814 EFI_VARSTORE_ID VarStoreId;
815 union {
816 EFI_STRING_ID VarName;
817 UINT16 VarOffset;
818 } VarStoreInfo;
819 UINT8 Flags;
820 } EFI_IFR_QUESTION_HEADER;
821
822 //
823 // Flag values of EFI_IFR_QUESTION_HEADER
824 //
825 #define EFI_IFR_FLAG_READ_ONLY 0x01
826 #define EFI_IFR_FLAG_CALLBACK 0x04
827 #define EFI_IFR_FLAG_RESET_REQUIRED 0x10
828 #define EFI_IFR_FLAG_REST_STYLE 0x20
829 #define EFI_IFR_FLAG_RECONNECT_REQUIRED 0x40
830 #define EFI_IFR_FLAG_OPTIONS_ONLY 0x80
831
832 //
833 // Definition for Opcode Reference
834 // Section 27.3.8.3
835 //
836 typedef struct _EFI_IFR_DEFAULTSTORE {
837 EFI_IFR_OP_HEADER Header;
838 EFI_STRING_ID DefaultName;
839 UINT16 DefaultId;
840 } EFI_IFR_DEFAULTSTORE;
841
842 //
843 // Default Identifier of default store
844 //
845 #define EFI_HII_DEFAULT_CLASS_STANDARD 0x0000
846 #define EFI_HII_DEFAULT_CLASS_MANUFACTURING 0x0001
847 #define EFI_HII_DEFAULT_CLASS_SAFE 0x0002
848 #define EFI_HII_DEFAULT_CLASS_PLATFORM_BEGIN 0x4000
849 #define EFI_HII_DEFAULT_CLASS_PLATFORM_END 0x7fff
850 #define EFI_HII_DEFAULT_CLASS_HARDWARE_BEGIN 0x8000
851 #define EFI_HII_DEFAULT_CLASS_HARDWARE_END 0xbfff
852 #define EFI_HII_DEFAULT_CLASS_FIRMWARE_BEGIN 0xc000
853 #define EFI_HII_DEFAULT_CLASS_FIRMWARE_END 0xffff
854
855 typedef struct _EFI_IFR_VARSTORE {
856 EFI_IFR_OP_HEADER Header;
857 EFI_GUID Guid;
858 EFI_VARSTORE_ID VarStoreId;
859 UINT16 Size;
860 UINT8 Name[1];
861 } EFI_IFR_VARSTORE;
862
863 typedef struct _EFI_IFR_VARSTORE_EFI {
864 EFI_IFR_OP_HEADER Header;
865 EFI_VARSTORE_ID VarStoreId;
866 EFI_GUID Guid;
867 UINT32 Attributes;
868 UINT16 Size;
869 UINT8 Name[1];
870 } EFI_IFR_VARSTORE_EFI;
871
872 typedef struct _EFI_IFR_VARSTORE_NAME_VALUE {
873 EFI_IFR_OP_HEADER Header;
874 EFI_VARSTORE_ID VarStoreId;
875 EFI_GUID Guid;
876 } EFI_IFR_VARSTORE_NAME_VALUE;
877
878 typedef struct _EFI_IFR_FORM_SET {
879 EFI_IFR_OP_HEADER Header;
880 EFI_GUID Guid;
881 EFI_STRING_ID FormSetTitle;
882 EFI_STRING_ID Help;
883 UINT8 Flags;
884 // EFI_GUID ClassGuid[];
885 } EFI_IFR_FORM_SET;
886
887 typedef struct _EFI_IFR_END {
888 EFI_IFR_OP_HEADER Header;
889 } EFI_IFR_END;
890
891 typedef struct _EFI_IFR_FORM {
892 EFI_IFR_OP_HEADER Header;
893 UINT16 FormId;
894 EFI_STRING_ID FormTitle;
895 } EFI_IFR_FORM;
896
897 typedef struct _EFI_IFR_IMAGE {
898 EFI_IFR_OP_HEADER Header;
899 EFI_IMAGE_ID Id;
900 } EFI_IFR_IMAGE;
901
902 typedef struct _EFI_IFR_MODAL_TAG {
903 EFI_IFR_OP_HEADER Header;
904 } EFI_IFR_MODAL_TAG;
905
906 typedef struct _EFI_IFR_LOCKED {
907 EFI_IFR_OP_HEADER Header;
908 } EFI_IFR_LOCKED;
909
910 typedef struct _EFI_IFR_RULE {
911 EFI_IFR_OP_HEADER Header;
912 UINT8 RuleId;
913 } EFI_IFR_RULE;
914
915 typedef struct _EFI_IFR_DEFAULT {
916 EFI_IFR_OP_HEADER Header;
917 UINT16 DefaultId;
918 UINT8 Type;
919 EFI_IFR_TYPE_VALUE Value;
920 } EFI_IFR_DEFAULT;
921
922 typedef struct _EFI_IFR_DEFAULT_2 {
923 EFI_IFR_OP_HEADER Header;
924 UINT16 DefaultId;
925 UINT8 Type;
926 } EFI_IFR_DEFAULT_2;
927
928 typedef struct _EFI_IFR_VALUE {
929 EFI_IFR_OP_HEADER Header;
930 } EFI_IFR_VALUE;
931
932 typedef struct _EFI_IFR_SUBTITLE {
933 EFI_IFR_OP_HEADER Header;
934 EFI_IFR_STATEMENT_HEADER Statement;
935 UINT8 Flags;
936 } EFI_IFR_SUBTITLE;
937
938 #define EFI_IFR_FLAGS_HORIZONTAL 0x01
939
940 typedef struct _EFI_IFR_CHECKBOX {
941 EFI_IFR_OP_HEADER Header;
942 EFI_IFR_QUESTION_HEADER Question;
943 UINT8 Flags;
944 } EFI_IFR_CHECKBOX;
945
946 #define EFI_IFR_CHECKBOX_DEFAULT 0x01
947 #define EFI_IFR_CHECKBOX_DEFAULT_MFG 0x02
948
949 typedef struct _EFI_IFR_TEXT {
950 EFI_IFR_OP_HEADER Header;
951 EFI_IFR_STATEMENT_HEADER Statement;
952 EFI_STRING_ID TextTwo;
953 } EFI_IFR_TEXT;
954
955 typedef struct _EFI_IFR_REF {
956 EFI_IFR_OP_HEADER Header;
957 EFI_IFR_QUESTION_HEADER Question;
958 EFI_FORM_ID FormId;
959 } EFI_IFR_REF;
960
961 typedef struct _EFI_IFR_REF2 {
962 EFI_IFR_OP_HEADER Header;
963 EFI_IFR_QUESTION_HEADER Question;
964 EFI_FORM_ID FormId;
965 EFI_QUESTION_ID QuestionId;
966 } EFI_IFR_REF2;
967
968 typedef struct _EFI_IFR_REF3 {
969 EFI_IFR_OP_HEADER Header;
970 EFI_IFR_QUESTION_HEADER Question;
971 EFI_FORM_ID FormId;
972 EFI_QUESTION_ID QuestionId;
973 EFI_GUID FormSetId;
974 } EFI_IFR_REF3;
975
976 typedef struct _EFI_IFR_REF4 {
977 EFI_IFR_OP_HEADER Header;
978 EFI_IFR_QUESTION_HEADER Question;
979 EFI_FORM_ID FormId;
980 EFI_QUESTION_ID QuestionId;
981 EFI_GUID FormSetId;
982 EFI_STRING_ID DevicePath;
983 } EFI_IFR_REF4;
984
985 typedef struct _EFI_IFR_REF5 {
986 EFI_IFR_OP_HEADER Header;
987 EFI_IFR_QUESTION_HEADER Question;
988 } EFI_IFR_REF5;
989
990 typedef struct _EFI_IFR_RESET_BUTTON {
991 EFI_IFR_OP_HEADER Header;
992 EFI_IFR_STATEMENT_HEADER Statement;
993 EFI_DEFAULT_ID DefaultId;
994 } EFI_IFR_RESET_BUTTON;
995
996 typedef struct _EFI_IFR_ACTION {
997 EFI_IFR_OP_HEADER Header;
998 EFI_IFR_QUESTION_HEADER Question;
999 EFI_STRING_ID QuestionConfig;
1000 } EFI_IFR_ACTION;
1001
1002 typedef struct _EFI_IFR_ACTION_1 {
1003 EFI_IFR_OP_HEADER Header;
1004 EFI_IFR_QUESTION_HEADER Question;
1005 } EFI_IFR_ACTION_1;
1006
1007 typedef struct _EFI_IFR_DATE {
1008 EFI_IFR_OP_HEADER Header;
1009 EFI_IFR_QUESTION_HEADER Question;
1010 UINT8 Flags;
1011 } EFI_IFR_DATE;
1012
1013 //
1014 // Flags that describe the behavior of the question.
1015 //
1016 #define EFI_QF_DATE_YEAR_SUPPRESS 0x01
1017 #define EFI_QF_DATE_MONTH_SUPPRESS 0x02
1018 #define EFI_QF_DATE_DAY_SUPPRESS 0x04
1019
1020 #define EFI_QF_DATE_STORAGE 0x30
1021 #define QF_DATE_STORAGE_NORMAL 0x00
1022 #define QF_DATE_STORAGE_TIME 0x10
1023 #define QF_DATE_STORAGE_WAKEUP 0x20
1024
1025 typedef union {
1026 struct {
1027 UINT8 MinValue;
1028 UINT8 MaxValue;
1029 UINT8 Step;
1030 } u8;
1031 struct {
1032 UINT16 MinValue;
1033 UINT16 MaxValue;
1034 UINT16 Step;
1035 } u16;
1036 struct {
1037 UINT32 MinValue;
1038 UINT32 MaxValue;
1039 UINT32 Step;
1040 } u32;
1041 struct {
1042 UINT64 MinValue;
1043 UINT64 MaxValue;
1044 UINT64 Step;
1045 } u64;
1046 } MINMAXSTEP_DATA;
1047
1048 typedef struct _EFI_IFR_NUMERIC {
1049 EFI_IFR_OP_HEADER Header;
1050 EFI_IFR_QUESTION_HEADER Question;
1051 UINT8 Flags;
1052 MINMAXSTEP_DATA data;
1053 } EFI_IFR_NUMERIC;
1054
1055 //
1056 // Flags related to the numeric question
1057 //
1058 #define EFI_IFR_NUMERIC_SIZE 0x03
1059 #define EFI_IFR_NUMERIC_SIZE_1 0x00
1060 #define EFI_IFR_NUMERIC_SIZE_2 0x01
1061 #define EFI_IFR_NUMERIC_SIZE_4 0x02
1062 #define EFI_IFR_NUMERIC_SIZE_8 0x03
1063
1064 #define EFI_IFR_DISPLAY 0x30
1065 #define EFI_IFR_DISPLAY_INT_DEC 0x00
1066 #define EFI_IFR_DISPLAY_UINT_DEC 0x10
1067 #define EFI_IFR_DISPLAY_UINT_HEX 0x20
1068
1069 typedef struct _EFI_IFR_ONE_OF {
1070 EFI_IFR_OP_HEADER Header;
1071 EFI_IFR_QUESTION_HEADER Question;
1072 UINT8 Flags;
1073 MINMAXSTEP_DATA data;
1074 } EFI_IFR_ONE_OF;
1075
1076 typedef struct _EFI_IFR_STRING {
1077 EFI_IFR_OP_HEADER Header;
1078 EFI_IFR_QUESTION_HEADER Question;
1079 UINT8 MinSize;
1080 UINT8 MaxSize;
1081 UINT8 Flags;
1082 } EFI_IFR_STRING;
1083
1084 #define EFI_IFR_STRING_MULTI_LINE 0x01
1085
1086 typedef struct _EFI_IFR_PASSWORD {
1087 EFI_IFR_OP_HEADER Header;
1088 EFI_IFR_QUESTION_HEADER Question;
1089 UINT16 MinSize;
1090 UINT16 MaxSize;
1091 } EFI_IFR_PASSWORD;
1092
1093 typedef struct _EFI_IFR_ORDERED_LIST {
1094 EFI_IFR_OP_HEADER Header;
1095 EFI_IFR_QUESTION_HEADER Question;
1096 UINT8 MaxContainers;
1097 UINT8 Flags;
1098 } EFI_IFR_ORDERED_LIST;
1099
1100 #define EFI_IFR_UNIQUE_SET 0x01
1101 #define EFI_IFR_NO_EMPTY_SET 0x02
1102
1103 typedef struct _EFI_IFR_TIME {
1104 EFI_IFR_OP_HEADER Header;
1105 EFI_IFR_QUESTION_HEADER Question;
1106 UINT8 Flags;
1107 } EFI_IFR_TIME;
1108
1109 //
1110 // A bit-mask that determines which unique settings are active for this opcode.
1111 //
1112 #define QF_TIME_HOUR_SUPPRESS 0x01
1113 #define QF_TIME_MINUTE_SUPPRESS 0x02
1114 #define QF_TIME_SECOND_SUPPRESS 0x04
1115
1116 #define QF_TIME_STORAGE 0x30
1117 #define QF_TIME_STORAGE_NORMAL 0x00
1118 #define QF_TIME_STORAGE_TIME 0x10
1119 #define QF_TIME_STORAGE_WAKEUP 0x20
1120
1121 typedef struct _EFI_IFR_DISABLE_IF {
1122 EFI_IFR_OP_HEADER Header;
1123 } EFI_IFR_DISABLE_IF;
1124
1125 typedef struct _EFI_IFR_SUPPRESS_IF {
1126 EFI_IFR_OP_HEADER Header;
1127 } EFI_IFR_SUPPRESS_IF;
1128
1129 typedef struct _EFI_IFR_GRAY_OUT_IF {
1130 EFI_IFR_OP_HEADER Header;
1131 } EFI_IFR_GRAY_OUT_IF;
1132
1133 typedef struct _EFI_IFR_INCONSISTENT_IF {
1134 EFI_IFR_OP_HEADER Header;
1135 EFI_STRING_ID Error;
1136 } EFI_IFR_INCONSISTENT_IF;
1137
1138 typedef struct _EFI_IFR_NO_SUBMIT_IF {
1139 EFI_IFR_OP_HEADER Header;
1140 EFI_STRING_ID Error;
1141 } EFI_IFR_NO_SUBMIT_IF;
1142
1143 typedef struct _EFI_IFR_WARNING_IF {
1144 EFI_IFR_OP_HEADER Header;
1145 EFI_STRING_ID Warning;
1146 UINT8 TimeOut;
1147 } EFI_IFR_WARNING_IF;
1148
1149 typedef struct _EFI_IFR_REFRESH {
1150 EFI_IFR_OP_HEADER Header;
1151 UINT8 RefreshInterval;
1152 } EFI_IFR_REFRESH;
1153
1154 typedef struct _EFI_IFR_VARSTORE_DEVICE {
1155 EFI_IFR_OP_HEADER Header;
1156 EFI_STRING_ID DevicePath;
1157 } EFI_IFR_VARSTORE_DEVICE;
1158
1159 typedef struct _EFI_IFR_ONE_OF_OPTION {
1160 EFI_IFR_OP_HEADER Header;
1161 EFI_STRING_ID Option;
1162 UINT8 Flags;
1163 UINT8 Type;
1164 EFI_IFR_TYPE_VALUE Value;
1165 } EFI_IFR_ONE_OF_OPTION;
1166
1167 //
1168 // Types of the option's value.
1169 //
1170 #define EFI_IFR_TYPE_NUM_SIZE_8 0x00
1171 #define EFI_IFR_TYPE_NUM_SIZE_16 0x01
1172 #define EFI_IFR_TYPE_NUM_SIZE_32 0x02
1173 #define EFI_IFR_TYPE_NUM_SIZE_64 0x03
1174 #define EFI_IFR_TYPE_BOOLEAN 0x04
1175 #define EFI_IFR_TYPE_TIME 0x05
1176 #define EFI_IFR_TYPE_DATE 0x06
1177 #define EFI_IFR_TYPE_STRING 0x07
1178 #define EFI_IFR_TYPE_OTHER 0x08
1179 #define EFI_IFR_TYPE_UNDEFINED 0x09
1180 #define EFI_IFR_TYPE_ACTION 0x0A
1181 #define EFI_IFR_TYPE_BUFFER 0x0B
1182 #define EFI_IFR_TYPE_REF 0x0C
1183
1184 #define EFI_IFR_OPTION_DEFAULT 0x10
1185 #define EFI_IFR_OPTION_DEFAULT_MFG 0x20
1186
1187 typedef struct _EFI_IFR_GUID {
1188 EFI_IFR_OP_HEADER Header;
1189 EFI_GUID Guid;
1190 //Optional Data Follows
1191 } EFI_IFR_GUID;
1192
1193 typedef struct _EFI_IFR_REFRESH_ID {
1194 EFI_IFR_OP_HEADER Header;
1195 EFI_GUID RefreshEventGroupId;
1196 } EFI_IFR_REFRESH_ID;
1197
1198 typedef struct _EFI_IFR_DUP {
1199 EFI_IFR_OP_HEADER Header;
1200 } EFI_IFR_DUP;
1201
1202 typedef struct _EFI_IFR_EQ_ID_ID {
1203 EFI_IFR_OP_HEADER Header;
1204 EFI_QUESTION_ID QuestionId1;
1205 EFI_QUESTION_ID QuestionId2;
1206 } EFI_IFR_EQ_ID_ID;
1207
1208 typedef struct _EFI_IFR_EQ_ID_VAL {
1209 EFI_IFR_OP_HEADER Header;
1210 EFI_QUESTION_ID QuestionId;
1211 UINT16 Value;
1212 } EFI_IFR_EQ_ID_VAL;
1213
1214 typedef struct _EFI_IFR_EQ_ID_VAL_LIST {
1215 EFI_IFR_OP_HEADER Header;
1216 EFI_QUESTION_ID QuestionId;
1217 UINT16 ListLength;
1218 UINT16 ValueList[1];
1219 } EFI_IFR_EQ_ID_VAL_LIST;
1220
1221 typedef struct _EFI_IFR_UINT8 {
1222 EFI_IFR_OP_HEADER Header;
1223 UINT8 Value;
1224 } EFI_IFR_UINT8;
1225
1226 typedef struct _EFI_IFR_UINT16 {
1227 EFI_IFR_OP_HEADER Header;
1228 UINT16 Value;
1229 } EFI_IFR_UINT16;
1230
1231 typedef struct _EFI_IFR_UINT32 {
1232 EFI_IFR_OP_HEADER Header;
1233 UINT32 Value;
1234 } EFI_IFR_UINT32;
1235
1236 typedef struct _EFI_IFR_UINT64 {
1237 EFI_IFR_OP_HEADER Header;
1238 UINT64 Value;
1239 } EFI_IFR_UINT64;
1240
1241 typedef struct _EFI_IFR_QUESTION_REF1 {
1242 EFI_IFR_OP_HEADER Header;
1243 EFI_QUESTION_ID QuestionId;
1244 } EFI_IFR_QUESTION_REF1;
1245
1246 typedef struct _EFI_IFR_QUESTION_REF2 {
1247 EFI_IFR_OP_HEADER Header;
1248 } EFI_IFR_QUESTION_REF2;
1249
1250 typedef struct _EFI_IFR_QUESTION_REF3 {
1251 EFI_IFR_OP_HEADER Header;
1252 } EFI_IFR_QUESTION_REF3;
1253
1254 typedef struct _EFI_IFR_QUESTION_REF3_2 {
1255 EFI_IFR_OP_HEADER Header;
1256 EFI_STRING_ID DevicePath;
1257 } EFI_IFR_QUESTION_REF3_2;
1258
1259 typedef struct _EFI_IFR_QUESTION_REF3_3 {
1260 EFI_IFR_OP_HEADER Header;
1261 EFI_STRING_ID DevicePath;
1262 EFI_GUID Guid;
1263 } EFI_IFR_QUESTION_REF3_3;
1264
1265 typedef struct _EFI_IFR_RULE_REF {
1266 EFI_IFR_OP_HEADER Header;
1267 UINT8 RuleId;
1268 } EFI_IFR_RULE_REF;
1269
1270 typedef struct _EFI_IFR_STRING_REF1 {
1271 EFI_IFR_OP_HEADER Header;
1272 EFI_STRING_ID StringId;
1273 } EFI_IFR_STRING_REF1;
1274
1275 typedef struct _EFI_IFR_STRING_REF2 {
1276 EFI_IFR_OP_HEADER Header;
1277 } EFI_IFR_STRING_REF2;
1278
1279 typedef struct _EFI_IFR_THIS {
1280 EFI_IFR_OP_HEADER Header;
1281 } EFI_IFR_THIS;
1282
1283 typedef struct _EFI_IFR_TRUE {
1284 EFI_IFR_OP_HEADER Header;
1285 } EFI_IFR_TRUE;
1286
1287 typedef struct _EFI_IFR_FALSE {
1288 EFI_IFR_OP_HEADER Header;
1289 } EFI_IFR_FALSE;
1290
1291 typedef struct _EFI_IFR_ONE {
1292 EFI_IFR_OP_HEADER Header;
1293 } EFI_IFR_ONE;
1294
1295 typedef struct _EFI_IFR_ONES {
1296 EFI_IFR_OP_HEADER Header;
1297 } EFI_IFR_ONES;
1298
1299 typedef struct _EFI_IFR_ZERO {
1300 EFI_IFR_OP_HEADER Header;
1301 } EFI_IFR_ZERO;
1302
1303 typedef struct _EFI_IFR_UNDEFINED {
1304 EFI_IFR_OP_HEADER Header;
1305 } EFI_IFR_UNDEFINED;
1306
1307 typedef struct _EFI_IFR_VERSION {
1308 EFI_IFR_OP_HEADER Header;
1309 } EFI_IFR_VERSION;
1310
1311 typedef struct _EFI_IFR_LENGTH {
1312 EFI_IFR_OP_HEADER Header;
1313 } EFI_IFR_LENGTH;
1314
1315 typedef struct _EFI_IFR_NOT {
1316 EFI_IFR_OP_HEADER Header;
1317 } EFI_IFR_NOT;
1318
1319 typedef struct _EFI_IFR_BITWISE_NOT {
1320 EFI_IFR_OP_HEADER Header;
1321 } EFI_IFR_BITWISE_NOT;
1322
1323 typedef struct _EFI_IFR_TO_BOOLEAN {
1324 EFI_IFR_OP_HEADER Header;
1325 } EFI_IFR_TO_BOOLEAN;
1326
1327 ///
1328 /// For EFI_IFR_TO_STRING, when converting from
1329 /// unsigned integers, these flags control the format:
1330 /// 0 = unsigned decimal.
1331 /// 1 = signed decimal.
1332 /// 2 = hexadecimal (lower-case alpha).
1333 /// 3 = hexadecimal (upper-case alpha).
1334 ///@{
1335 #define EFI_IFR_STRING_UNSIGNED_DEC 0
1336 #define EFI_IFR_STRING_SIGNED_DEC 1
1337 #define EFI_IFR_STRING_LOWERCASE_HEX 2
1338 #define EFI_IFR_STRING_UPPERCASE_HEX 3
1339 ///@}
1340
1341 ///
1342 /// When converting from a buffer, these flags control the format:
1343 /// 0 = ASCII.
1344 /// 8 = Unicode.
1345 ///@{
1346 #define EFI_IFR_STRING_ASCII 0
1347 #define EFI_IFR_STRING_UNICODE 8
1348 ///@}
1349
1350 typedef struct _EFI_IFR_TO_STRING {
1351 EFI_IFR_OP_HEADER Header;
1352 UINT8 Format;
1353 } EFI_IFR_TO_STRING;
1354
1355 typedef struct _EFI_IFR_TO_UINT {
1356 EFI_IFR_OP_HEADER Header;
1357 } EFI_IFR_TO_UINT;
1358
1359 typedef struct _EFI_IFR_TO_UPPER {
1360 EFI_IFR_OP_HEADER Header;
1361 } EFI_IFR_TO_UPPER;
1362
1363 typedef struct _EFI_IFR_TO_LOWER {
1364 EFI_IFR_OP_HEADER Header;
1365 } EFI_IFR_TO_LOWER;
1366
1367 typedef struct _EFI_IFR_ADD {
1368 EFI_IFR_OP_HEADER Header;
1369 } EFI_IFR_ADD;
1370
1371 typedef struct _EFI_IFR_AND {
1372 EFI_IFR_OP_HEADER Header;
1373 } EFI_IFR_AND;
1374
1375 typedef struct _EFI_IFR_BITWISE_AND {
1376 EFI_IFR_OP_HEADER Header;
1377 } EFI_IFR_BITWISE_AND;
1378
1379 typedef struct _EFI_IFR_BITWISE_OR {
1380 EFI_IFR_OP_HEADER Header;
1381 } EFI_IFR_BITWISE_OR;
1382
1383 typedef struct _EFI_IFR_CATENATE {
1384 EFI_IFR_OP_HEADER Header;
1385 } EFI_IFR_CATENATE;
1386
1387 typedef struct _EFI_IFR_DIVIDE {
1388 EFI_IFR_OP_HEADER Header;
1389 } EFI_IFR_DIVIDE;
1390
1391 typedef struct _EFI_IFR_EQUAL {
1392 EFI_IFR_OP_HEADER Header;
1393 } EFI_IFR_EQUAL;
1394
1395 typedef struct _EFI_IFR_GREATER_EQUAL {
1396 EFI_IFR_OP_HEADER Header;
1397 } EFI_IFR_GREATER_EQUAL;
1398
1399 typedef struct _EFI_IFR_GREATER_THAN {
1400 EFI_IFR_OP_HEADER Header;
1401 } EFI_IFR_GREATER_THAN;
1402
1403 typedef struct _EFI_IFR_LESS_EQUAL {
1404 EFI_IFR_OP_HEADER Header;
1405 } EFI_IFR_LESS_EQUAL;
1406
1407 typedef struct _EFI_IFR_LESS_THAN {
1408 EFI_IFR_OP_HEADER Header;
1409 } EFI_IFR_LESS_THAN;
1410
1411 typedef struct _EFI_IFR_MATCH {
1412 EFI_IFR_OP_HEADER Header;
1413 } EFI_IFR_MATCH;
1414
1415 typedef struct _EFI_IFR_MATCH2 {
1416 EFI_IFR_OP_HEADER Header;
1417 EFI_GUID SyntaxType;
1418 } EFI_IFR_MATCH2;
1419
1420 typedef struct _EFI_IFR_MULTIPLY {
1421 EFI_IFR_OP_HEADER Header;
1422 } EFI_IFR_MULTIPLY;
1423
1424 typedef struct _EFI_IFR_MODULO {
1425 EFI_IFR_OP_HEADER Header;
1426 } EFI_IFR_MODULO;
1427
1428 typedef struct _EFI_IFR_NOT_EQUAL {
1429 EFI_IFR_OP_HEADER Header;
1430 } EFI_IFR_NOT_EQUAL;
1431
1432 typedef struct _EFI_IFR_OR {
1433 EFI_IFR_OP_HEADER Header;
1434 } EFI_IFR_OR;
1435
1436 typedef struct _EFI_IFR_SHIFT_LEFT {
1437 EFI_IFR_OP_HEADER Header;
1438 } EFI_IFR_SHIFT_LEFT;
1439
1440 typedef struct _EFI_IFR_SHIFT_RIGHT {
1441 EFI_IFR_OP_HEADER Header;
1442 } EFI_IFR_SHIFT_RIGHT;
1443
1444 typedef struct _EFI_IFR_SUBTRACT {
1445 EFI_IFR_OP_HEADER Header;
1446 } EFI_IFR_SUBTRACT;
1447
1448 typedef struct _EFI_IFR_CONDITIONAL {
1449 EFI_IFR_OP_HEADER Header;
1450 } EFI_IFR_CONDITIONAL;
1451
1452 //
1453 // Flags governing the matching criteria of EFI_IFR_FIND
1454 //
1455 #define EFI_IFR_FF_CASE_SENSITIVE 0x00
1456 #define EFI_IFR_FF_CASE_INSENSITIVE 0x01
1457
1458 typedef struct _EFI_IFR_FIND {
1459 EFI_IFR_OP_HEADER Header;
1460 UINT8 Format;
1461 } EFI_IFR_FIND;
1462
1463 typedef struct _EFI_IFR_MID {
1464 EFI_IFR_OP_HEADER Header;
1465 } EFI_IFR_MID;
1466
1467 typedef struct _EFI_IFR_TOKEN {
1468 EFI_IFR_OP_HEADER Header;
1469 } EFI_IFR_TOKEN;
1470
1471 //
1472 // Flags specifying whether to find the first matching string
1473 // or the first non-matching string.
1474 //
1475 #define EFI_IFR_FLAGS_FIRST_MATCHING 0x00
1476 #define EFI_IFR_FLAGS_FIRST_NON_MATCHING 0x01
1477
1478 typedef struct _EFI_IFR_SPAN {
1479 EFI_IFR_OP_HEADER Header;
1480 UINT8 Flags;
1481 } EFI_IFR_SPAN;
1482
1483 typedef struct _EFI_IFR_SECURITY {
1484 ///
1485 /// Standard opcode header, where Header.Op = EFI_IFR_SECURITY_OP.
1486 ///
1487 EFI_IFR_OP_HEADER Header;
1488 ///
1489 /// Security permission level.
1490 ///
1491 EFI_GUID Permissions;
1492 } EFI_IFR_SECURITY;
1493
1494 typedef struct _EFI_IFR_FORM_MAP_METHOD {
1495 ///
1496 /// The string identifier which provides the human-readable name of
1497 /// the configuration method for this standards map form.
1498 ///
1499 EFI_STRING_ID MethodTitle;
1500 ///
1501 /// Identifier which uniquely specifies the configuration methods
1502 /// associated with this standards map form.
1503 ///
1504 EFI_GUID MethodIdentifier;
1505 } EFI_IFR_FORM_MAP_METHOD;
1506
1507 typedef struct _EFI_IFR_FORM_MAP {
1508 ///
1509 /// The sequence that defines the type of opcode as well as the length
1510 /// of the opcode being defined. Header.OpCode = EFI_IFR_FORM_MAP_OP.
1511 ///
1512 EFI_IFR_OP_HEADER Header;
1513 ///
1514 /// The unique identifier for this particular form.
1515 ///
1516 EFI_FORM_ID FormId;
1517 ///
1518 /// One or more configuration method's name and unique identifier.
1519 ///
1520 // EFI_IFR_FORM_MAP_METHOD Methods[];
1521 } EFI_IFR_FORM_MAP;
1522
1523 typedef struct _EFI_IFR_SET {
1524 ///
1525 /// The sequence that defines the type of opcode as well as the length
1526 /// of the opcode being defined. Header.OpCode = EFI_IFR_SET_OP.
1527 ///
1528 EFI_IFR_OP_HEADER Header;
1529 ///
1530 /// Specifies the identifier of a previously declared variable store to
1531 /// use when storing the question's value.
1532 ///
1533 EFI_VARSTORE_ID VarStoreId;
1534 union {
1535 ///
1536 /// A 16-bit Buffer Storage offset.
1537 ///
1538 EFI_STRING_ID VarName;
1539 ///
1540 /// A Name Value or EFI Variable name (VarName).
1541 ///
1542 UINT16 VarOffset;
1543 } VarStoreInfo;
1544 ///
1545 /// Specifies the type used for storage.
1546 ///
1547 UINT8 VarStoreType;
1548 } EFI_IFR_SET;
1549
1550 typedef struct _EFI_IFR_GET {
1551 ///
1552 /// The sequence that defines the type of opcode as well as the length
1553 /// of the opcode being defined. Header.OpCode = EFI_IFR_GET_OP.
1554 ///
1555 EFI_IFR_OP_HEADER Header;
1556 ///
1557 /// Specifies the identifier of a previously declared variable store to
1558 /// use when retrieving the value.
1559 ///
1560 EFI_VARSTORE_ID VarStoreId;
1561 union {
1562 ///
1563 /// A 16-bit Buffer Storage offset.
1564 ///
1565 EFI_STRING_ID VarName;
1566 ///
1567 /// A Name Value or EFI Variable name (VarName).
1568 ///
1569 UINT16 VarOffset;
1570 } VarStoreInfo;
1571 ///
1572 /// Specifies the type used for storage.
1573 ///
1574 UINT8 VarStoreType;
1575 } EFI_IFR_GET;
1576
1577 typedef struct _EFI_IFR_READ {
1578 EFI_IFR_OP_HEADER Header;
1579 } EFI_IFR_READ;
1580
1581 typedef struct _EFI_IFR_WRITE {
1582 EFI_IFR_OP_HEADER Header;
1583 } EFI_IFR_WRITE;
1584
1585 typedef struct _EFI_IFR_MAP {
1586 EFI_IFR_OP_HEADER Header;
1587 } EFI_IFR_MAP;
1588 //
1589 // Definitions for Keyboard Package
1590 // Releated definitions are in Section of EFI_HII_DATABASE_PROTOCOL
1591 //
1592
1593 ///
1594 /// Each enumeration values maps a physical key on a keyboard.
1595 ///
1596 typedef enum {
1597 EfiKeyLCtrl,
1598 EfiKeyA0,
1599 EfiKeyLAlt,
1600 EfiKeySpaceBar,
1601 EfiKeyA2,
1602 EfiKeyA3,
1603 EfiKeyA4,
1604 EfiKeyRCtrl,
1605 EfiKeyLeftArrow,
1606 EfiKeyDownArrow,
1607 EfiKeyRightArrow,
1608 EfiKeyZero,
1609 EfiKeyPeriod,
1610 EfiKeyEnter,
1611 EfiKeyLShift,
1612 EfiKeyB0,
1613 EfiKeyB1,
1614 EfiKeyB2,
1615 EfiKeyB3,
1616 EfiKeyB4,
1617 EfiKeyB5,
1618 EfiKeyB6,
1619 EfiKeyB7,
1620 EfiKeyB8,
1621 EfiKeyB9,
1622 EfiKeyB10,
1623 EfiKeyRShift,
1624 EfiKeyUpArrow,
1625 EfiKeyOne,
1626 EfiKeyTwo,
1627 EfiKeyThree,
1628 EfiKeyCapsLock,
1629 EfiKeyC1,
1630 EfiKeyC2,
1631 EfiKeyC3,
1632 EfiKeyC4,
1633 EfiKeyC5,
1634 EfiKeyC6,
1635 EfiKeyC7,
1636 EfiKeyC8,
1637 EfiKeyC9,
1638 EfiKeyC10,
1639 EfiKeyC11,
1640 EfiKeyC12,
1641 EfiKeyFour,
1642 EfiKeyFive,
1643 EfiKeySix,
1644 EfiKeyPlus,
1645 EfiKeyTab,
1646 EfiKeyD1,
1647 EfiKeyD2,
1648 EfiKeyD3,
1649 EfiKeyD4,
1650 EfiKeyD5,
1651 EfiKeyD6,
1652 EfiKeyD7,
1653 EfiKeyD8,
1654 EfiKeyD9,
1655 EfiKeyD10,
1656 EfiKeyD11,
1657 EfiKeyD12,
1658 EfiKeyD13,
1659 EfiKeyDel,
1660 EfiKeyEnd,
1661 EfiKeyPgDn,
1662 EfiKeySeven,
1663 EfiKeyEight,
1664 EfiKeyNine,
1665 EfiKeyE0,
1666 EfiKeyE1,
1667 EfiKeyE2,
1668 EfiKeyE3,
1669 EfiKeyE4,
1670 EfiKeyE5,
1671 EfiKeyE6,
1672 EfiKeyE7,
1673 EfiKeyE8,
1674 EfiKeyE9,
1675 EfiKeyE10,
1676 EfiKeyE11,
1677 EfiKeyE12,
1678 EfiKeyBackSpace,
1679 EfiKeyIns,
1680 EfiKeyHome,
1681 EfiKeyPgUp,
1682 EfiKeyNLck,
1683 EfiKeySlash,
1684 EfiKeyAsterisk,
1685 EfiKeyMinus,
1686 EfiKeyEsc,
1687 EfiKeyF1,
1688 EfiKeyF2,
1689 EfiKeyF3,
1690 EfiKeyF4,
1691 EfiKeyF5,
1692 EfiKeyF6,
1693 EfiKeyF7,
1694 EfiKeyF8,
1695 EfiKeyF9,
1696 EfiKeyF10,
1697 EfiKeyF11,
1698 EfiKeyF12,
1699 EfiKeyPrint,
1700 EfiKeySLck,
1701 EfiKeyPause
1702 } EFI_KEY;
1703
1704 typedef struct {
1705 ///
1706 /// Used to describe a physical key on a keyboard.
1707 ///
1708 EFI_KEY Key;
1709 ///
1710 /// Unicode character code for the Key.
1711 ///
1712 CHAR16 Unicode;
1713 ///
1714 /// Unicode character code for the key with the shift key being held down.
1715 ///
1716 CHAR16 ShiftedUnicode;
1717 ///
1718 /// Unicode character code for the key with the Alt-GR being held down.
1719 ///
1720 CHAR16 AltGrUnicode;
1721 ///
1722 /// Unicode character code for the key with the Alt-GR and shift keys being held down.
1723 ///
1724 CHAR16 ShiftedAltGrUnicode;
1725 ///
1726 /// Modifier keys are defined to allow for special functionality that is not necessarily
1727 /// accomplished by a printable character. Many of these modifier keys are flags to toggle
1728 /// certain state bits on and off inside of a keyboard driver.
1729 ///
1730 UINT16 Modifier;
1731 UINT16 AffectedAttribute;
1732 } EFI_KEY_DESCRIPTOR;
1733
1734 ///
1735 /// A key which is affected by all the standard shift modifiers.
1736 /// Most keys would be expected to have this bit active.
1737 ///
1738 #define EFI_AFFECTED_BY_STANDARD_SHIFT 0x0001
1739
1740 ///
1741 /// This key is affected by the caps lock so that if a keyboard driver
1742 /// would need to disambiguate between a key which had a "1" defined
1743 /// versus an "a" character. Having this bit turned on would tell
1744 /// the keyboard driver to use the appropriate shifted state or not.
1745 ///
1746 #define EFI_AFFECTED_BY_CAPS_LOCK 0x0002
1747
1748 ///
1749 /// Similar to the case of CAPS lock, if this bit is active, the key
1750 /// is affected by the num lock being turned on.
1751 ///
1752 #define EFI_AFFECTED_BY_NUM_LOCK 0x0004
1753
1754 typedef struct {
1755 UINT16 LayoutLength;
1756 EFI_GUID Guid;
1757 UINT32 LayoutDescriptorStringOffset;
1758 UINT8 DescriptorCount;
1759 // EFI_KEY_DESCRIPTOR Descriptors[];
1760 } EFI_HII_KEYBOARD_LAYOUT;
1761
1762 typedef struct {
1763 EFI_HII_PACKAGE_HEADER Header;
1764 UINT16 LayoutCount;
1765 // EFI_HII_KEYBOARD_LAYOUT Layout[];
1766 } EFI_HII_KEYBOARD_PACKAGE_HDR;
1767
1768 //
1769 // Modifier values
1770 //
1771 #define EFI_NULL_MODIFIER 0x0000
1772 #define EFI_LEFT_CONTROL_MODIFIER 0x0001
1773 #define EFI_RIGHT_CONTROL_MODIFIER 0x0002
1774 #define EFI_LEFT_ALT_MODIFIER 0x0003
1775 #define EFI_RIGHT_ALT_MODIFIER 0x0004
1776 #define EFI_ALT_GR_MODIFIER 0x0005
1777 #define EFI_INSERT_MODIFIER 0x0006
1778 #define EFI_DELETE_MODIFIER 0x0007
1779 #define EFI_PAGE_DOWN_MODIFIER 0x0008
1780 #define EFI_PAGE_UP_MODIFIER 0x0009
1781 #define EFI_HOME_MODIFIER 0x000A
1782 #define EFI_END_MODIFIER 0x000B
1783 #define EFI_LEFT_SHIFT_MODIFIER 0x000C
1784 #define EFI_RIGHT_SHIFT_MODIFIER 0x000D
1785 #define EFI_CAPS_LOCK_MODIFIER 0x000E
1786 #define EFI_NUM_LOCK_MODIFIER 0x000F
1787 #define EFI_LEFT_ARROW_MODIFIER 0x0010
1788 #define EFI_RIGHT_ARROW_MODIFIER 0x0011
1789 #define EFI_DOWN_ARROW_MODIFIER 0x0012
1790 #define EFI_UP_ARROW_MODIFIER 0x0013
1791 #define EFI_NS_KEY_MODIFIER 0x0014
1792 #define EFI_NS_KEY_DEPENDENCY_MODIFIER 0x0015
1793 #define EFI_FUNCTION_KEY_ONE_MODIFIER 0x0016
1794 #define EFI_FUNCTION_KEY_TWO_MODIFIER 0x0017
1795 #define EFI_FUNCTION_KEY_THREE_MODIFIER 0x0018
1796 #define EFI_FUNCTION_KEY_FOUR_MODIFIER 0x0019
1797 #define EFI_FUNCTION_KEY_FIVE_MODIFIER 0x001A
1798 #define EFI_FUNCTION_KEY_SIX_MODIFIER 0x001B
1799 #define EFI_FUNCTION_KEY_SEVEN_MODIFIER 0x001C
1800 #define EFI_FUNCTION_KEY_EIGHT_MODIFIER 0x001D
1801 #define EFI_FUNCTION_KEY_NINE_MODIFIER 0x001E
1802 #define EFI_FUNCTION_KEY_TEN_MODIFIER 0x001F
1803 #define EFI_FUNCTION_KEY_ELEVEN_MODIFIER 0x0020
1804 #define EFI_FUNCTION_KEY_TWELVE_MODIFIER 0x0021
1805
1806 //
1807 // Keys that have multiple control functions based on modifier
1808 // settings are handled in the keyboard driver implementation.
1809 // For instance, PRINT_KEY might have a modifier held down and
1810 // is still a nonprinting character, but might have an alternate
1811 // control function like SYSREQUEST
1812 //
1813 #define EFI_PRINT_MODIFIER 0x0022
1814 #define EFI_SYS_REQUEST_MODIFIER 0x0023
1815 #define EFI_SCROLL_LOCK_MODIFIER 0x0024
1816 #define EFI_PAUSE_MODIFIER 0x0025
1817 #define EFI_BREAK_MODIFIER 0x0026
1818
1819 #define EFI_LEFT_LOGO_MODIFIER 0x0027
1820 #define EFI_RIGHT_LOGO_MODIFIER 0x0028
1821 #define EFI_MENU_MODIFIER 0x0029
1822
1823 ///
1824 /// Animation IFR opcode
1825 ///
1826 typedef struct _EFI_IFR_ANIMATION {
1827 ///
1828 /// Standard opcode header, where Header.OpCode is
1829 /// EFI_IFR_ANIMATION_OP.
1830 ///
1831 EFI_IFR_OP_HEADER Header;
1832 ///
1833 /// Animation identifier in the HII database.
1834 ///
1835 EFI_ANIMATION_ID Id;
1836 } EFI_IFR_ANIMATION;
1837
1838 ///
1839 /// HII animation package header.
1840 ///
1841 typedef struct _EFI_HII_ANIMATION_PACKAGE_HDR {
1842 ///
1843 /// Standard package header, where Header.Type = EFI_HII_PACKAGE_ANIMATIONS.
1844 ///
1845 EFI_HII_PACKAGE_HEADER Header;
1846 ///
1847 /// Offset, relative to this header, of the animation information. If
1848 /// this is zero, then there are no animation sequences in the package.
1849 ///
1850 UINT32 AnimationInfoOffset;
1851 } EFI_HII_ANIMATION_PACKAGE_HDR;
1852
1853 ///
1854 /// Animation information is encoded as a series of blocks,
1855 /// with each block prefixed by a single byte header EFI_HII_ANIMATION_BLOCK.
1856 ///
1857 typedef struct _EFI_HII_ANIMATION_BLOCK {
1858 UINT8 BlockType;
1859 //UINT8 BlockBody[];
1860 } EFI_HII_ANIMATION_BLOCK;
1861
1862 ///
1863 /// Animation block types.
1864 ///
1865 #define EFI_HII_AIBT_END 0x00
1866 #define EFI_HII_AIBT_OVERLAY_IMAGES 0x10
1867 #define EFI_HII_AIBT_CLEAR_IMAGES 0x11
1868 #define EFI_HII_AIBT_RESTORE_SCRN 0x12
1869 #define EFI_HII_AIBT_OVERLAY_IMAGES_LOOP 0x18
1870 #define EFI_HII_AIBT_CLEAR_IMAGES_LOOP 0x19
1871 #define EFI_HII_AIBT_RESTORE_SCRN_LOOP 0x1A
1872 #define EFI_HII_AIBT_DUPLICATE 0x20
1873 #define EFI_HII_AIBT_SKIP2 0x21
1874 #define EFI_HII_AIBT_SKIP1 0x22
1875 #define EFI_HII_AIBT_EXT1 0x30
1876 #define EFI_HII_AIBT_EXT2 0x31
1877 #define EFI_HII_AIBT_EXT4 0x32
1878
1879 ///
1880 /// Extended block headers used for variable sized animation records
1881 /// which need an explicit length.
1882 ///
1883
1884 typedef struct _EFI_HII_AIBT_EXT1_BLOCK {
1885 ///
1886 /// Standard animation header, where Header.BlockType = EFI_HII_AIBT_EXT1.
1887 ///
1888 EFI_HII_ANIMATION_BLOCK Header;
1889 ///
1890 /// The block type.
1891 ///
1892 UINT8 BlockType2;
1893 ///
1894 /// Size of the animation block, in bytes, including the animation block header.
1895 ///
1896 UINT8 Length;
1897 } EFI_HII_AIBT_EXT1_BLOCK;
1898
1899 typedef struct _EFI_HII_AIBT_EXT2_BLOCK {
1900 ///
1901 /// Standard animation header, where Header.BlockType = EFI_HII_AIBT_EXT2.
1902 ///
1903 EFI_HII_ANIMATION_BLOCK Header;
1904 ///
1905 /// The block type
1906 ///
1907 UINT8 BlockType2;
1908 ///
1909 /// Size of the animation block, in bytes, including the animation block header.
1910 ///
1911 UINT16 Length;
1912 } EFI_HII_AIBT_EXT2_BLOCK;
1913
1914 typedef struct _EFI_HII_AIBT_EXT4_BLOCK {
1915 ///
1916 /// Standard animation header, where Header.BlockType = EFI_HII_AIBT_EXT4.
1917 ///
1918 EFI_HII_ANIMATION_BLOCK Header;
1919 ///
1920 /// The block type
1921 ///
1922 UINT8 BlockType2;
1923 ///
1924 /// Size of the animation block, in bytes, including the animation block header.
1925 ///
1926 UINT32 Length;
1927 } EFI_HII_AIBT_EXT4_BLOCK;
1928
1929 typedef struct _EFI_HII_ANIMATION_CELL {
1930 ///
1931 /// The X offset from the upper left hand corner of the logical
1932 /// window to position the indexed image.
1933 ///
1934 UINT16 OffsetX;
1935 ///
1936 /// The Y offset from the upper left hand corner of the logical
1937 /// window to position the indexed image.
1938 ///
1939 UINT16 OffsetY;
1940 ///
1941 /// The image to display at the specified offset from the upper left
1942 /// hand corner of the logical window.
1943 ///
1944 EFI_IMAGE_ID ImageId;
1945 ///
1946 /// The number of milliseconds to delay after displaying the indexed
1947 /// image and before continuing on to the next linked image. If value
1948 /// is zero, no delay.
1949 ///
1950 UINT16 Delay;
1951 } EFI_HII_ANIMATION_CELL;
1952
1953 ///
1954 /// An animation block to describe an animation sequence that does not cycle, and
1955 /// where one image is simply displayed over the previous image.
1956 ///
1957 typedef struct _EFI_HII_AIBT_OVERLAY_IMAGES_BLOCK {
1958 ///
1959 /// This is image that is to be reference by the image protocols, if the
1960 /// animation function is not supported or disabled. This image can
1961 /// be one particular image from the animation sequence (if any one
1962 /// of the animation frames has a complete image) or an alternate
1963 /// image that can be displayed alone. If the value is zero, no image
1964 /// is displayed.
1965 ///
1966 EFI_IMAGE_ID DftImageId;
1967 ///
1968 /// The overall width of the set of images (logical window width).
1969 ///
1970 UINT16 Width;
1971 ///
1972 /// The overall height of the set of images (logical window height).
1973 ///
1974 UINT16 Height;
1975 ///
1976 /// The number of EFI_HII_ANIMATION_CELL contained in the
1977 /// animation sequence.
1978 ///
1979 UINT16 CellCount;
1980 ///
1981 /// An array of CellCount animation cells.
1982 ///
1983 EFI_HII_ANIMATION_CELL AnimationCell[1];
1984 } EFI_HII_AIBT_OVERLAY_IMAGES_BLOCK;
1985
1986 ///
1987 /// An animation block to describe an animation sequence that does not cycle,
1988 /// and where the logical window is cleared to the specified color before
1989 /// the next image is displayed.
1990 ///
1991 typedef struct _EFI_HII_AIBT_CLEAR_IMAGES_BLOCK {
1992 ///
1993 /// This is image that is to be reference by the image protocols, if the
1994 /// animation function is not supported or disabled. This image can
1995 /// be one particular image from the animation sequence (if any one
1996 /// of the animation frames has a complete image) or an alternate
1997 /// image that can be displayed alone. If the value is zero, no image
1998 /// is displayed.
1999 ///
2000 EFI_IMAGE_ID DftImageId;
2001 ///
2002 /// The overall width of the set of images (logical window width).
2003 ///
2004 UINT16 Width;
2005 ///
2006 /// The overall height of the set of images (logical window height).
2007 ///
2008 UINT16 Height;
2009 ///
2010 /// The number of EFI_HII_ANIMATION_CELL contained in the
2011 /// animation sequence.
2012 ///
2013 UINT16 CellCount;
2014 ///
2015 /// The color to clear the logical window to before displaying the
2016 /// indexed image.
2017 ///
2018 EFI_HII_RGB_PIXEL BackgndColor;
2019 ///
2020 /// An array of CellCount animation cells.
2021 ///
2022 EFI_HII_ANIMATION_CELL AnimationCell[1];
2023 } EFI_HII_AIBT_CLEAR_IMAGES_BLOCK;
2024
2025 ///
2026 /// An animation block to describe an animation sequence that does not cycle,
2027 /// and where the screen is restored to the original state before the next
2028 /// image is displayed.
2029 ///
2030 typedef struct _EFI_HII_AIBT_RESTORE_SCRN_BLOCK {
2031 ///
2032 /// This is image that is to be reference by the image protocols, if the
2033 /// animation function is not supported or disabled. This image can
2034 /// be one particular image from the animation sequence (if any one
2035 /// of the animation frames has a complete image) or an alternate
2036 /// image that can be displayed alone. If the value is zero, no image
2037 /// is displayed.
2038 ///
2039 EFI_IMAGE_ID DftImageId;
2040 ///
2041 /// The overall width of the set of images (logical window width).
2042 ///
2043 UINT16 Width;
2044 ///
2045 /// The overall height of the set of images (logical window height).
2046 ///
2047 UINT16 Height;
2048 ///
2049 /// The number of EFI_HII_ANIMATION_CELL contained in the
2050 /// animation sequence.
2051 ///
2052 UINT16 CellCount;
2053 ///
2054 /// An array of CellCount animation cells.
2055 ///
2056 EFI_HII_ANIMATION_CELL AnimationCell[1];
2057 } EFI_HII_AIBT_RESTORE_SCRN_BLOCK;
2058
2059 ///
2060 /// An animation block to describe an animation sequence that continuously cycles,
2061 /// and where one image is simply displayed over the previous image.
2062 ///
2063 typedef EFI_HII_AIBT_OVERLAY_IMAGES_BLOCK EFI_HII_AIBT_OVERLAY_IMAGES_LOOP_BLOCK;
2064
2065 ///
2066 /// An animation block to describe an animation sequence that continuously cycles,
2067 /// and where the logical window is cleared to the specified color before
2068 /// the next image is displayed.
2069 ///
2070 typedef EFI_HII_AIBT_CLEAR_IMAGES_BLOCK EFI_HII_AIBT_CLEAR_IMAGES_LOOP_BLOCK;
2071
2072 ///
2073 /// An animation block to describe an animation sequence that continuously cycles,
2074 /// and where the screen is restored to the original state before
2075 /// the next image is displayed.
2076 ///
2077 typedef EFI_HII_AIBT_RESTORE_SCRN_BLOCK EFI_HII_AIBT_RESTORE_SCRN_LOOP_BLOCK;
2078
2079 ///
2080 /// Assigns a new character value to a previously defined animation sequence.
2081 ///
2082 typedef struct _EFI_HII_AIBT_DUPLICATE_BLOCK {
2083 ///
2084 /// The previously defined animation ID with the exact same
2085 /// animation information.
2086 ///
2087 EFI_ANIMATION_ID AnimationId;
2088 } EFI_HII_AIBT_DUPLICATE_BLOCK;
2089
2090 ///
2091 /// Skips animation IDs.
2092 ///
2093 typedef struct _EFI_HII_AIBT_SKIP1_BLOCK {
2094 ///
2095 /// The unsigned 8-bit value to add to AnimationIdCurrent.
2096 ///
2097 UINT8 SkipCount;
2098 } EFI_HII_AIBT_SKIP1_BLOCK;
2099
2100 ///
2101 /// Skips animation IDs.
2102 ///
2103 typedef struct _EFI_HII_AIBT_SKIP2_BLOCK {
2104 ///
2105 /// The unsigned 16-bit value to add to AnimationIdCurrent.
2106 ///
2107 UINT16 SkipCount;
2108 } EFI_HII_AIBT_SKIP2_BLOCK;
2109
2110 #pragma pack()
2111
2112
2113
2114 ///
2115 /// References to string tokens must use this macro to enable scanning for
2116 /// token usages.
2117 ///
2118 ///
2119 /// STRING_TOKEN is not defined in UEFI specification. But it is placed
2120 /// here for the easy access by C files and VFR source files.
2121 ///
2122 #define STRING_TOKEN(t) t
2123
2124 ///
2125 /// IMAGE_TOKEN is not defined in UEFI specification. But it is placed
2126 /// here for the easy access by C files and VFR source files.
2127 ///
2128 #define IMAGE_TOKEN(t) t
2129
2130 #endif