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