tyler.durden/audk
1
0
Fork 0
mirror of https://github.com/acidanthera/audk.git synced 2025-07-28 16:14:04 +02:00
Code Issues Packages Projects Releases Wiki Activity

1) Move RFC_3066_ENTRY_SIZE and ISO_639_2_ENTRY_SIZE to UefiBaseType.h.

Browse Source 
2) Rename BufToHexString to BufInReverseOrderToHexString 
3) Rename HexStringToBuf to HexStringToBufInReverseOrder
4) Update function comments in HiiLib.h and IfrSupportLib.h.


git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@5989 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
qwang12 2008-09-26 06:20:19 +00:00
parent a64823fb4e
commit f4e8509b62
6 changed files with 110 additions and 60 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
MdePkg/Include/Library/HiiLib.h
View File

@ -16,8 +16,6 @@
#define __HII_LIB_H__ #define __HII_LIB_H__
#define ISO_639_2_ENTRY_SIZE 3
/** /**
Assemble EFI_HII_PACKAGE_LIST according to the passed in packages. Assemble EFI_HII_PACKAGE_LIST according to the passed in packages.

82
MdePkg/Include/Library/IfrSupportLib.h
View File

@ -1,6 +1,6 @@
/** @file /** @file
The file contain all library functions and definitions for IFR opcode creation and This library contains functions to do IFR opcode creation and utility functions
related Form Browser utility Operations. to help module to interact with a UEFI Form Browser.
Copyright (c) 2007 - 2008, Intel Corporation Copyright (c) 2007 - 2008, Intel Corporation
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials
@ -39,13 +39,6 @@
#define UEFI_LANGUAGE_VARIABLE L"PlatformLang" #define UEFI_LANGUAGE_VARIABLE L"PlatformLang"
#define UEFI_LANGUAGE_CODES_VARIABLE L"PlatformLangCodes" #define UEFI_LANGUAGE_CODES_VARIABLE L"PlatformLangCodes"
///
/// Limited buffer size recommended by RFC3066
/// (42 characters plus a NULL terminator)
///
#define RFC_3066_ENTRY_SIZE (42 + 1)
#define ISO_639_2_ENTRY_SIZE 3
#define INVALID_VARSTORE_ID 0 #define INVALID_VARSTORE_ID 0
#define QUESTION_FLAGS (EFI_IFR_FLAG_READ_ONLY | EFI_IFR_FLAG_CALLBACK | EFI_IFR_FLAG_RESET_REQUIRED | EFI_IFR_FLAG_OPTIONS_ONLY) #define QUESTION_FLAGS (EFI_IFR_FLAG_READ_ONLY | EFI_IFR_FLAG_CALLBACK | EFI_IFR_FLAG_RESET_REQUIRED | EFI_IFR_FLAG_OPTIONS_ONLY)
@ -86,7 +79,7 @@ typedef struct {
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
**/ **/
@ -100,11 +93,13 @@ CreateEndOpCode (
/** /**
Create EFI_IFR_DEFAULT_OP opcode. Create EFI_IFR_DEFAULT_OP opcode.
If Data is NULL or Data->Data is NULL, then ASSERT.
@param Value Value for the default @param Value Value for the default
@param Type Type for the default @param Type Type for the default
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
@retval EFI_INVALID_PARAMETER The type is not valid. @retval EFI_INVALID_PARAMETER The type is not valid.
@ -121,6 +116,8 @@ CreateDefaultOpCode (
/** /**
Create EFI_IFR_ACTION_OP opcode. Create EFI_IFR_ACTION_OP opcode.
If Data is NULL or Data->Data is NULL, then ASSERT.
@param QuestionId Question ID @param QuestionId Question ID
@param Prompt String ID for Prompt @param Prompt String ID for Prompt
@param Help String ID for Help @param Help String ID for Help
@ -128,7 +125,7 @@ CreateDefaultOpCode (
@param QuestionConfig String ID for configuration @param QuestionConfig String ID for configuration
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
@retval EFI_INVALID_PARAMETER If QuestionFlags is not valid. @retval EFI_INVALID_PARAMETER If QuestionFlags is not valid.
@ -148,13 +145,15 @@ CreateActionOpCode (
/** /**
Create EFI_IFR_SUBTITLE_OP opcode. Create EFI_IFR_SUBTITLE_OP opcode.
If Data is NULL or Data->Data is NULL, then ASSERT.
@param Prompt String ID for Prompt @param Prompt String ID for Prompt
@param Help String ID for Help @param Help String ID for Help
@param Flags Subtitle opcode flags @param Flags Subtitle opcode flags
@param Scope Subtitle Scope bit @param Scope Subtitle Scope bit
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
**/ **/
@ -172,12 +171,14 @@ CreateSubTitleOpCode (
/** /**
Create EFI_IFR_TEXT_OP opcode. Create EFI_IFR_TEXT_OP opcode.
If Data is NULL or Data->Data is NULL, then ASSERT.
@param Prompt String ID for Prompt @param Prompt String ID for Prompt
@param Help String ID for Help @param Help String ID for Help
@param TextTwo String ID for text two @param TextTwo String ID for text two
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
**/ **/
@ -194,6 +195,8 @@ CreateTextOpCode (
/** /**
Create EFI_IFR_REF_OP opcode. Create EFI_IFR_REF_OP opcode.
If Data is NULL or Data->Data is NULL, then ASSERT.
@param FormId Destination Form ID @param FormId Destination Form ID
@param Prompt String ID for Prompt @param Prompt String ID for Prompt
@param Help String ID for Help @param Help String ID for Help
@ -201,7 +204,7 @@ CreateTextOpCode (
@param QuestionId Question ID @param QuestionId Question ID
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
@retval EFI_INVALID_PARAMETER If QuestionFlags is not valid. @retval EFI_INVALID_PARAMETER If QuestionFlags is not valid.
@ -221,13 +224,16 @@ CreateGotoOpCode (
/** /**
Create EFI_IFR_ONE_OF_OPTION_OP opcode. Create EFI_IFR_ONE_OF_OPTION_OP opcode.
If Data is NULL or Data->Data is NULL, then ASSERT.
@param OptionCount The number of options. @param OptionCount The number of options.
@param OptionsList The list of Options. @param OptionsList The list of Options.
@param Type The data type. @param Type The data type.
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
@retval EFI_INVALID_PARAMETER If OptionCount is not zero but OptionsList is NULL.
**/ **/
EFI_STATUS EFI_STATUS
@ -243,6 +249,8 @@ CreateOneOfOptionOpCode (
/** /**
Create EFI_IFR_ONE_OF_OP opcode. Create EFI_IFR_ONE_OF_OP opcode.
If Data is NULL or Data->Data is NULL, then ASSERT.
@param QuestionId Question ID @param QuestionId Question ID
@param VarStoreId Storage ID @param VarStoreId Storage ID
@param VarOffset Offset in Storage @param VarOffset Offset in Storage
@ -254,7 +262,7 @@ CreateOneOfOptionOpCode (
@param OptionCount Number of options in option list @param OptionCount Number of options in option list
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
@retval EFI_INVALID_PARAMETER If QuestionFlags is not valid. @retval EFI_INVALID_PARAMETER If QuestionFlags is not valid.
@ -278,6 +286,8 @@ CreateOneOfOpCode (
/** /**
Create EFI_IFR_ORDERED_LIST_OP opcode. Create EFI_IFR_ORDERED_LIST_OP opcode.
If Data is NULL or Data->Data is NULL, then ASSERT.
@param QuestionId Question ID @param QuestionId Question ID
@param VarStoreId Storage ID @param VarStoreId Storage ID
@param VarOffset Offset in Storage @param VarOffset Offset in Storage
@ -291,7 +301,7 @@ CreateOneOfOpCode (
@param OptionCount Number of options in option list @param OptionCount Number of options in option list
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
@retval EFI_INVALID_PARAMETER If QuestionFlags is not valid. @retval EFI_INVALID_PARAMETER If QuestionFlags is not valid.
@ -317,6 +327,8 @@ CreateOrderedListOpCode (
/** /**
Create EFI_IFR_CHECKBOX_OP opcode. Create EFI_IFR_CHECKBOX_OP opcode.
If Data is NULL or Data->Data is NULL, then ASSERT.
@param QuestionId Question ID @param QuestionId Question ID
@param VarStoreId Storage ID @param VarStoreId Storage ID
@param VarOffset Offset in Storage @param VarOffset Offset in Storage
@ -326,7 +338,7 @@ CreateOrderedListOpCode (
@param CheckBoxFlags Flags for checkbox opcode @param CheckBoxFlags Flags for checkbox opcode
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
@retval EFI_INVALID_PARAMETER If QuestionFlags is not valid. @retval EFI_INVALID_PARAMETER If QuestionFlags is not valid.
@ -348,6 +360,8 @@ CreateCheckBoxOpCode (
/** /**
Create EFI_IFR_NUMERIC_OP opcode. Create EFI_IFR_NUMERIC_OP opcode.
If Data is NULL or Data->Data is NULL, then ASSERT.
@param QuestionId Question ID @param QuestionId Question ID
@param VarStoreId Storage ID @param VarStoreId Storage ID
@param VarOffset Offset in Storage @param VarOffset Offset in Storage
@ -361,7 +375,7 @@ CreateCheckBoxOpCode (
@param Default Numeric default value @param Default Numeric default value
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
@retval EFI_INVALID_PARAMETER If QuestionFlags is not valid. @retval EFI_INVALID_PARAMETER If QuestionFlags is not valid.
@ -387,6 +401,8 @@ CreateNumericOpCode (
/** /**
Create EFI_IFR_STRING_OP opcode. Create EFI_IFR_STRING_OP opcode.
If Data is NULL or Data->Data is NULL, then ASSERT.
@param QuestionId Question ID @param QuestionId Question ID
@param VarStoreId Storage ID @param VarStoreId Storage ID
@param VarOffset Offset in Storage @param VarOffset Offset in Storage
@ -398,7 +414,7 @@ CreateNumericOpCode (
@param MaxSize String maximum length @param MaxSize String maximum length
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
@retval EFI_INVALID_PARAMETER If QuestionFlags is not valid. @retval EFI_INVALID_PARAMETER If QuestionFlags is not valid.
@ -434,18 +450,20 @@ ToLower (
; ;
/** /**
Converts binary buffer to Unicode string in reversed byte order to BufToHexString(). Converts binary buffer to a Unicode string. The byte buffer is in a reversed byte order
compared with the byte order defined in BufToHexString().
@param Str String for output @param Str String for output
@param Buffer Binary buffer. @param Buffer Binary buffer.
@param BufferSize Size of the buffer in bytes. @param BufferSize Size of the buffer in bytes.
@retval EFI_SUCCESS The function completed successfully. @retval EFI_SUCCESS The function completed successfully.
@retval EFI_OUT_OF_RESOURCES There is no enough available memory space.
**/ **/
EFI_STATUS EFI_STATUS
EFIAPI EFIAPI
BufferToHexString ( BufInReverseOrderToHexString (
IN OUT CHAR16 *Str, IN OUT CHAR16 *Str,
IN UINT8 *Buffer, IN UINT8 *Buffer,
IN UINTN BufferSize IN UINTN BufferSize
@ -464,11 +482,13 @@ BufferToHexString (
@param Str String to be converted from. @param Str String to be converted from.
@retval EFI_SUCCESS The function completed successfully. @retval EFI_SUCCESS The function completed successfully.
@retval RETURN_BUFFER_TOO_SMALL The input BufferSize is too small to hold the output. BufferSize
will be updated to the size required for the converstion.
**/ **/
EFI_STATUS EFI_STATUS
EFIAPI EFIAPI
HexStringToBuffer ( HexStringToBufInReverseOrder (
IN OUT UINT8 *Buffer, IN OUT UINT8 *Buffer,
IN OUT UINTN *BufferSize, IN OUT UINTN *BufferSize,
IN CHAR16 *Str IN CHAR16 *Str
@ -484,11 +504,11 @@ HexStringToBuffer (
@param StrBufferLen On input: Length in bytes of buffer to hold the Unicode string. @param StrBufferLen On input: Length in bytes of buffer to hold the Unicode string.
Includes tailing '\0' character. Includes tailing '\0' character.
On output: On output:
If return EFI_SUCCESS, containing length of Unicode string buffer. containing length of Unicode string buffer when returning EFI_SUCCESS;
If return EFI_BUFFER_TOO_SMALL, containg length of string buffer desired. containg length of string buffer desired when returning EFI_BUFFER_TOO_SMALL.
@param ConfigString Binary representation of Unicode String, <string> := (<HexCh>4)+ @param ConfigString Binary representation of Unicode String, <string> := (<HexCh>4)+
@retval EFI_SUCCESS Routine success. @retval EFI_SUCCESS Operation completes successfully.
@retval EFI_BUFFER_TOO_SMALL The string buffer is too small. @retval EFI_BUFFER_TOO_SMALL The string buffer is too small.
**/ **/
@ -514,7 +534,7 @@ ConfigStringToUnicode (
If return EFI_BUFFER_TOO_SMALL, containg length of string buffer desired. If return EFI_BUFFER_TOO_SMALL, containg length of string buffer desired.
@param UnicodeString Original Unicode string. @param UnicodeString Original Unicode string.
@retval EFI_SUCCESS Routine success. @retval EFI_SUCCESS Operation completes successfully.
@retval EFI_BUFFER_TOO_SMALL The string buffer is too small. @retval EFI_BUFFER_TOO_SMALL The string buffer is too small.
**/ **/
@ -542,7 +562,7 @@ UnicodeToConfigString (
@param DriverHandle Driver handle which contains the routing @param DriverHandle Driver handle which contains the routing
information: PATH. information: PATH.
@retval EFI_SUCCESS Routine success. @retval EFI_SUCCESS Operation completes successfully.
@retval EFI_BUFFER_TOO_SMALL The ConfigHdr string buffer is too small. @retval EFI_BUFFER_TOO_SMALL The ConfigHdr string buffer is too small.
**/ **/
@ -591,7 +611,7 @@ FindBlockName (
desired. desired.
@param Buffer Buffer to hold retrived data. @param Buffer Buffer to hold retrived data.
@retval EFI_SUCCESS Routine success. @retval EFI_SUCCESS Operation completes successfully.
@retval EFI_BUFFER_TOO_SMALL The intput buffer is too small. @retval EFI_BUFFER_TOO_SMALL The intput buffer is too small.
**/ **/
@ -620,7 +640,7 @@ GetBrowserData (
Browser. <RequestElement> ::= Browser. <RequestElement> ::=
&OFFSET=<Number>&WIDTH=<Number>* &OFFSET=<Number>&WIDTH=<Number>*
@retval EFI_SUCCESS Routine success. @retval EFI_SUCCESS Operation completes successfully.
@retval Other Updating Browser uncommitted data failed. @retval Other Updating Browser uncommitted data failed.
**/ **/

6
MdePkg/Include/Library/UefiLib.h
View File

@ -22,12 +22,6 @@
#include <Protocol/DriverDiagnostics.h> #include <Protocol/DriverDiagnostics.h>
#include <Protocol/DriverDiagnostics2.h> #include <Protocol/DriverDiagnostics2.h>
///
/// Limited buffer size recommended by RFC3066
/// (42 characters plus a NULL terminator)
///
#define RFC_3066_ENTRY_SIZE (42 + 1)
/// ///
/// Unicode String Table /// Unicode String Table
/// ///

13
MdePkg/Include/Uefi/UefiBaseType.h
View File

@ -169,4 +169,17 @@ typedef union {
#define EFI_MAX_BIT MAX_BIT #define EFI_MAX_BIT MAX_BIT
#define EFI_MAX_ADDRESS MAX_ADDRESS #define EFI_MAX_ADDRESS MAX_ADDRESS
///
/// Limited buffer size for a language code recommended by RFC3066
/// (42 characters plus a NULL terminator)
///
#define RFC_3066_ENTRY_SIZE (42 + 1)
///
/// The size of a 3 character ISO639 language code.
///
#define ISO_639_2_ENTRY_SIZE 3
#endif #endif

20
MdePkg/Library/IfrSupportLib/UefiIfrForm.c
View File

@ -359,7 +359,7 @@ ToLower (
**/ **/
EFI_STATUS EFI_STATUS
EFIAPI EFIAPI
BufferToHexString ( BufInReverseOrderToHexString (
IN OUT CHAR16 *Str, IN OUT CHAR16 *Str,
IN UINT8 *Buffer, IN UINT8 *Buffer,
IN UINTN BufferSize IN UINTN BufferSize
@ -400,11 +400,13 @@ BufferToHexString (
@param Str String to be converted from. @param Str String to be converted from.
@retval EFI_SUCCESS The function completed successfully. @retval EFI_SUCCESS The function completed successfully.
@retval RETURN_BUFFER_TOO_SMALL The input BufferSize is too small to hold the output. BufferSize
will be updated to the size required for the converstion.
**/ **/
EFI_STATUS EFI_STATUS
EFIAPI EFIAPI
HexStringToBuffer ( HexStringToBufInReverseOrder (
IN OUT UINT8 *Buffer, IN OUT UINT8 *Buffer,
IN OUT UINTN *BufferSize, IN OUT UINTN *BufferSize,
IN CHAR16 *Str IN CHAR16 *Str
@ -435,7 +437,7 @@ HexStringToBuffer (
If return EFI_BUFFER_TOO_SMALL, containg length of string buffer desired. If return EFI_BUFFER_TOO_SMALL, containg length of string buffer desired.
@param ConfigString Binary representation of Unicode String, <string> := (<HexCh>4)+ @param ConfigString Binary representation of Unicode String, <string> := (<HexCh>4)+
@retval EFI_SUCCESS Routine success. @retval EFI_SUCCESS Operation completes successfully.
@retval EFI_BUFFER_TOO_SMALL The string buffer is too small. @retval EFI_BUFFER_TOO_SMALL The string buffer is too small.
**/ **/
@ -495,7 +497,7 @@ ConfigStringToUnicode (
If return EFI_BUFFER_TOO_SMALL, containg length of string buffer desired. If return EFI_BUFFER_TOO_SMALL, containg length of string buffer desired.
@param UnicodeString Original Unicode string. @param UnicodeString Original Unicode string.
@retval EFI_SUCCESS Routine success. @retval EFI_SUCCESS Operation completes successfully.
@retval EFI_BUFFER_TOO_SMALL The string buffer is too small. @retval EFI_BUFFER_TOO_SMALL The string buffer is too small.
**/ **/
@ -557,7 +559,7 @@ UnicodeToConfigString (
@param DriverHandle Driver handle which contains the routing @param DriverHandle Driver handle which contains the routing
information: PATH. information: PATH.
@retval EFI_SUCCESS Routine success. @retval EFI_SUCCESS Operation completes successfully.
@retval EFI_BUFFER_TOO_SMALL The ConfigHdr string buffer is too small. @retval EFI_BUFFER_TOO_SMALL The ConfigHdr string buffer is too small.
**/ **/
@ -620,7 +622,7 @@ ConstructConfigHdr (
StrCpy (StrPtr, L"GUID="); StrCpy (StrPtr, L"GUID=");
StrPtr += 5; StrPtr += 5;
BufferToHexString (StrPtr, (UINT8 *) Guid, sizeof (EFI_GUID)); BufInReverseOrderToHexString (StrPtr, (UINT8 *) Guid, sizeof (EFI_GUID));
StrPtr += 32; StrPtr += 32;
// //
@ -636,7 +638,7 @@ ConstructConfigHdr (
StrCpy (StrPtr, L"&PATH="); StrCpy (StrPtr, L"&PATH=");
StrPtr += 6; StrPtr += 6;
BufferToHexString (StrPtr, (UINT8 *) DevicePath, DevicePathSize); BufInReverseOrderToHexString (StrPtr, (UINT8 *) DevicePath, DevicePathSize);
return EFI_SUCCESS; return EFI_SUCCESS;
} }
@ -719,7 +721,7 @@ FindBlockName (
desired. desired.
@param Buffer Buffer to hold retrived data. @param Buffer Buffer to hold retrived data.
@retval EFI_SUCCESS Routine success. @retval EFI_SUCCESS Operation completes successfully.
@retval EFI_BUFFER_TOO_SMALL The intput buffer is too small. @retval EFI_BUFFER_TOO_SMALL The intput buffer is too small.
@retval EFI_OUT_OF_RESOURCES There is no enough available memory space. @retval EFI_OUT_OF_RESOURCES There is no enough available memory space.
@ -836,7 +838,7 @@ GetBrowserData (
Browser. <RequestElement> ::= Browser. <RequestElement> ::=
&OFFSET=<Number>&WIDTH=<Number>* &OFFSET=<Number>&WIDTH=<Number>*
@retval EFI_SUCCESS Routine success. @retval EFI_SUCCESS Operation completes successfully.
@retval EFI_OUT_OF_RESOURCES There is no enough available memory space. @retval EFI_OUT_OF_RESOURCES There is no enough available memory space.
@retval Other Updating Browser uncommitted data failed. @retval Other Updating Browser uncommitted data failed.

47
MdePkg/Library/IfrSupportLib/UefiIfrOpCodeCreation.c
View File

@ -103,7 +103,7 @@ IsValidCheckboxFlags (
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
**/ **/
@ -139,11 +139,13 @@ CreateEndOpCode (
/** /**
Create EFI_IFR_DEFAULT_OP opcode. Create EFI_IFR_DEFAULT_OP opcode.
If Data is NULL or Data->Data is NULL, then ASSERT.
@param Value Value for the default @param Value Value for the default
@param Type Type for the default @param Type Type for the default
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
@retval EFI_INVALID_PARAMETER The type is not valid. @retval EFI_INVALID_PARAMETER The type is not valid.
@ -189,6 +191,8 @@ CreateDefaultOpCode (
/** /**
Create EFI_IFR_ACTION_OP opcode. Create EFI_IFR_ACTION_OP opcode.
If Data is NULL or Data->Data is NULL, then ASSERT.
@param QuestionId Question ID @param QuestionId Question ID
@param Prompt String ID for Prompt @param Prompt String ID for Prompt
@param Help String ID for Help @param Help String ID for Help
@ -196,7 +200,7 @@ CreateDefaultOpCode (
@param QuestionConfig String ID for configuration @param QuestionConfig String ID for configuration
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
@retval EFI_INVALID_PARAMETER If QuestionFlags is not valid. @retval EFI_INVALID_PARAMETER If QuestionFlags is not valid.
@ -248,13 +252,15 @@ CreateActionOpCode (
/** /**
Create EFI_IFR_SUBTITLE_OP opcode. Create EFI_IFR_SUBTITLE_OP opcode.
If Data is NULL or Data->Data is NULL, then ASSERT.
@param Prompt String ID for Prompt @param Prompt String ID for Prompt
@param Help String ID for Help @param Help String ID for Help
@param Flags Subtitle opcode flags @param Flags Subtitle opcode flags
@param Scope Subtitle Scope bit @param Scope Subtitle Scope bit
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
**/ **/
@ -298,12 +304,14 @@ CreateSubTitleOpCode (
/** /**
Create EFI_IFR_TEXT_OP opcode. Create EFI_IFR_TEXT_OP opcode.
If Data is NULL or Data->Data is NULL, then ASSERT.
@param Prompt String ID for Prompt @param Prompt String ID for Prompt
@param Help String ID for Help @param Help String ID for Help
@param TextTwo String ID for text two @param TextTwo String ID for text two
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
**/ **/
@ -345,6 +353,8 @@ CreateTextOpCode (
/** /**
Create EFI_IFR_REF_OP opcode. Create EFI_IFR_REF_OP opcode.
If Data is NULL or Data->Data is NULL, then ASSERT.
@param FormId Destination Form ID @param FormId Destination Form ID
@param Prompt String ID for Prompt @param Prompt String ID for Prompt
@param Help String ID for Help @param Help String ID for Help
@ -352,7 +362,7 @@ CreateTextOpCode (
@param QuestionId Question ID @param QuestionId Question ID
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
@retval EFI_INVALID_PARAMETER If QuestionFlags is not valid. @retval EFI_INVALID_PARAMETER If QuestionFlags is not valid.
@ -404,13 +414,16 @@ CreateGotoOpCode (
/** /**
Create EFI_IFR_ONE_OF_OPTION_OP opcode. Create EFI_IFR_ONE_OF_OPTION_OP opcode.
If Data is NULL or Data->Data is NULL, then ASSERT.
@param OptionCount The number of options. @param OptionCount The number of options.
@param OptionsList The list of Options. @param OptionsList The list of Options.
@param Type The data type. @param Type The data type.
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
@retval EFI_INVALID_PARAMETER If OptionCount is not zero but OptionsList is NULL.
**/ **/
EFI_STATUS EFI_STATUS
@ -460,6 +473,8 @@ CreateOneOfOptionOpCode (
/** /**
Create EFI_IFR_ONE_OF_OP opcode. Create EFI_IFR_ONE_OF_OP opcode.
If Data is NULL or Data->Data is NULL, then ASSERT.
@param QuestionId Question ID @param QuestionId Question ID
@param VarStoreId Storage ID @param VarStoreId Storage ID
@param VarOffset Offset in Storage @param VarOffset Offset in Storage
@ -471,7 +486,7 @@ CreateOneOfOptionOpCode (
@param OptionCount Number of options in option list @param OptionCount Number of options in option list
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
@retval EFI_INVALID_PARAMETER If QuestionFlags is not valid. @retval EFI_INVALID_PARAMETER If QuestionFlags is not valid.
@ -537,6 +552,8 @@ CreateOneOfOpCode (
/** /**
Create EFI_IFR_ORDERED_LIST_OP opcode. Create EFI_IFR_ORDERED_LIST_OP opcode.
If Data is NULL or Data->Data is NULL, then ASSERT.
@param QuestionId Question ID @param QuestionId Question ID
@param VarStoreId Storage ID @param VarStoreId Storage ID
@param VarOffset Offset in Storage @param VarOffset Offset in Storage
@ -550,7 +567,7 @@ CreateOneOfOpCode (
@param OptionCount Number of options in option list @param OptionCount Number of options in option list
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
@retval EFI_INVALID_PARAMETER If QuestionFlags is not valid. @retval EFI_INVALID_PARAMETER If QuestionFlags is not valid.
@ -623,6 +640,8 @@ CreateOrderedListOpCode (
/** /**
Create EFI_IFR_CHECKBOX_OP opcode. Create EFI_IFR_CHECKBOX_OP opcode.
If Data is NULL or Data->Data is NULL, then ASSERT.
@param QuestionId Question ID @param QuestionId Question ID
@param VarStoreId Storage ID @param VarStoreId Storage ID
@param VarOffset Offset in Storage @param VarOffset Offset in Storage
@ -632,7 +651,7 @@ CreateOrderedListOpCode (
@param CheckBoxFlags Flags for checkbox opcode @param CheckBoxFlags Flags for checkbox opcode
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
@retval EFI_INVALID_PARAMETER If QuestionFlags is not valid. @retval EFI_INVALID_PARAMETER If QuestionFlags is not valid.
@ -687,6 +706,8 @@ CreateCheckBoxOpCode (
/** /**
Create EFI_IFR_NUMERIC_OP opcode. Create EFI_IFR_NUMERIC_OP opcode.
If Data is NULL or Data->Data is NULL, then ASSERT.
@param QuestionId Question ID @param QuestionId Question ID
@param VarStoreId Storage ID @param VarStoreId Storage ID
@param VarOffset Offset in Storage @param VarOffset Offset in Storage
@ -700,7 +721,7 @@ CreateCheckBoxOpCode (
@param Default Numeric default value @param Default Numeric default value
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
@retval EFI_INVALID_PARAMETER If QuestionFlags is not valid. @retval EFI_INVALID_PARAMETER If QuestionFlags is not valid.
@ -798,6 +819,8 @@ CreateNumericOpCode (
/** /**
Create EFI_IFR_STRING_OP opcode. Create EFI_IFR_STRING_OP opcode.
If Data is NULL or Data->Data is NULL, then ASSERT.
@param QuestionId Question ID @param QuestionId Question ID
@param VarStoreId Storage ID @param VarStoreId Storage ID
@param VarOffset Offset in Storage @param VarOffset Offset in Storage
@ -809,7 +832,7 @@ CreateNumericOpCode (
@param MaxSize String maximum length @param MaxSize String maximum length
@param Data Destination for the created opcode binary @param Data Destination for the created opcode binary
@retval EFI_SUCCESS Opcode create success @retval EFI_SUCCESS Opcode is created successfully.
@retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small. @retval EFI_BUFFER_TOO_SMALL The space reserved in Data field is too small.
@retval EFI_INVALID_PARAMETER If QuestionFlags is not valid. @retval EFI_INVALID_PARAMETER If QuestionFlags is not valid.