environment. There are a set of base libraries in the Mde Package that can\r
be used to implement base modules.\r
\r
-Copyright (c) 2006 - 2007, Intel Corporation\r
+Copyright (c) 2006 - 2008, Intel Corporation\r
All rights reserved. This program and the accompanying materials\r
are licensed and made available under the terms and conditions of the BSD License\r
which accompanies this distribution. The full text of the license may be found at\r
#define RETURN_CRC_ERROR ENCODE_ERROR (27)\r
#define RETURN_END_OF_MEDIA ENCODE_ERROR (28)\r
#define RETURN_END_OF_FILE ENCODE_ERROR (31)\r
+#define RETURN_INVALID_LANGUAGE ENCODE_ERROR (32)\r
+\r
\r
#define RETURN_WARN_UNKNOWN_GLYPH ENCODE_WARNING (1)\r
#define RETURN_WARN_DELETE_FAILURE ENCODE_WARNING (2)\r
The file contain all library functions and definitions for IFR opcode creation and
related Form Browser utility Operations.
- Copyright (c) 2007, Intel Corporation
+ Copyright (c) 2007 - 2008, Intel Corporation
All rights reserved. This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License
which accompanies this distribution. The full text of the license may be found at
)
;
+/**
+ Converts the unicode character of the string from uppercase to lowercase.
+
+ @param Str String to be converted
+
+ @retval VOID
+
+**/
+VOID
+ToLower (
+ IN OUT CHAR16 *Str
+ )
+;
+
/**
Converts binary buffer to Unicode string in reversed byte order to BufToHexString().
)
;
+/**
+ Convert binary representation Config string (e.g. "0041004200430044") to the
+ original string (e.g. "ABCD"). Config string appears in <ConfigHdr> (i.e.
+ "&NAME=<string>"), or Name/Value pair in <ConfigBody> (i.e. "label=<string>").
+
+ @param UnicodeString Original Unicode string.
+ @param StrBufferLen On input: Length in bytes of buffer to hold the Unicode string.
+ Includes tailing '\0' character.
+ On output:
+ If return EFI_SUCCESS, containing length of Unicode string buffer.
+ If return EFI_BUFFER_TOO_SMALL, containg length of string buffer desired.
+ @param ConfigString Binary representation of Unicode String, <string> := (<HexCh>4)+
+
+ @retval EFI_SUCCESS Routine success.
+ @retval EFI_BUFFER_TOO_SMALL The string buffer is too small.
+
+**/EFI_STATUS
+ConfigStringToUnicode (
+ IN OUT CHAR16 *UnicodeString,
+ IN OUT UINTN *StrBufferLen,
+ IN CHAR16 *ConfigString
+ )
+;
+
+/**
+ Convert Unicode string to binary representation Config string, e.g.
+ "ABCD" => "0041004200430044". Config string appears in <ConfigHdr> (i.e.
+ "&NAME=<string>"), or Name/Value pair in <ConfigBody> (i.e. "label=<string>").
+
+ @param ConfigString Binary representation of Unicode String, <string> := (<HexCh>4)+
+ @param StrBufferLen On input: Length in bytes of buffer to hold the Unicode string.
+ Includes tailing '\0' character.
+ On output:
+ If return EFI_SUCCESS, containing length of Unicode string buffer.
+ If return EFI_BUFFER_TOO_SMALL, containg length of string buffer desired.
+ @param UnicodeString Original Unicode string.
+
+ @retval EFI_SUCCESS Routine success.
+ @retval EFI_BUFFER_TOO_SMALL The string buffer is too small.
+
+**/EFI_STATUS
+UnicodeToConfigString (
+ IN OUT CHAR16 *ConfigString,
+ IN OUT UINTN *StrBufferLen,
+ IN CHAR16 *UnicodeString
+ )
+;
+
/**
Construct <ConfigHdr> using routing information GUID/NAME/PATH.
The file provides Database manager for HII-related data\r
structures.\r
\r
- Copyright (c) 2006 - 2007, Intel Corporation\r
+ Copyright (c) 2006 - 2008, Intel Corporation\r
All rights reserved. This program and the accompanying materials \r
are licensed and made available under the terms and conditions of the BSD License \r
which accompanies this distribution. The full text of the license may be found at \r
\r
@retval EFI_SUCCESS The data associated with the Handle was\r
removed from the HII database.\r
- \r
- @retval EFI_INVALID_PARAMETER The Handle was not valid.\r
+ @retval EFI_NOT_FOUND The specified Handle is not in database.\r
\r
**/\r
typedef\r
@retval EFI_OUT_OF_RESOURCES Unable to allocate enough memory\r
for the updated database.\r
\r
- @retval EFI_INVALID_PARAMETER The Handle was not valid.\r
+ @retval EFI_INVALID_PARAMETER PackageList was NULL.\r
+ @retval EFI_NOT_FOUND The specified Handle is not in database.\r
\r
**/\r
typedef\r
@param Handle An array of EFI_HII_HANDLE instances returned.\r
\r
\r
- @retval EFI_SUCCESS Handle was updated successfully.\r
+ @retval EFI_SUCCESS The matching handles are outputed successfully.\r
+ HandleBufferLength is updated with the actual length.\r
\r
- @retval EFI_BUFFER_TOO_SMALL The HandleBufferLength parameter\r
+ @retval EFI_BUFFER_TOO_SMALL The HandleBufferLength parameter\r
indicates that Handle is too\r
small to support the number of\r
handles. HandleBufferLength is\r
updated with a value that will\r
enable the data to fit.\r
+ @retval EFI_NOT_FOUND No matching handle could not be found in database.\r
+ @retval EFI_INVALID_PARAMETER Handle or HandleBufferLength was NULL.\r
+ @retval EFI_INVALID_PARAMETER PackageType is not a EFI_HII_PACKAGE_TYPE_GUID but\r
+ PackageGuid is not NULL, PackageType is a EFI_HII_\r
+ PACKAGE_TYPE_GUID but PackageGuid is NULL.\r
\r
\r
**/\r
@retval EFI_SUCCESS Unregister the notification\r
Successsfully\r
\r
- @retval EFI_INVALID_PARAMETER The Handle is invalid.\r
-\r
+ @retval EFI_NOT_FOUND The incoming notification handle does not exist \r
+ in current hii database.\r
+ \r
**/\r
typedef\r
EFI_STATUS\r
/** @file\r
The file provides services to retrieve font information.\r
\r
- Copyright (c) 2006 - 2007, Intel Corporation\r
+ Copyright (c) 2006 - 2008, Intel Corporation\r
All rights reserved. This program and the accompanying materials \r
are licensed and made available under the terms and conditions of the BSD License \r
which accompanies this distribution. The full text of the license may be found at \r
typedef UINT32 EFI_HII_OUT_FLAGS;\r
#define EFI_HII_OUT_FLAG_CLIP 0x00000001\r
#define EFI_HII_OUT_FLAG_WRAP 0x00000002\r
-#define EFI_HII_OUT_FLAG_CLEAN_Y 0x00000004\r
-#define EFI_HII_OUT_FLAG_CLEAN_X 0x00000008\r
+#define EFI_HII_OUT_FLAG_CLIP_CLEAN_Y 0x00000004\r
+#define EFI_HII_OUT_FLAG_CLIP_CLEAN_X 0x00000008\r
#define EFI_HII_OUT_FLAG_TRANSPARENT 0x00000010\r
#define EFI_HII_IGNORE_IF_NO_GLYPH 0x00000020\r
#define EFI_HII_IGNORE_LINE_BREAK 0x00000040\r
// EFI_FONT_INFO\r
// \r
typedef struct {\r
- UINT32 FontStyle;\r
- UINT16 FontSize;\r
- CHAR16 FontName[1];\r
+ EFI_HII_FONT_STYLE FontStyle;\r
+ UINT16 FontSize; // character cell height in pixels\r
+ CHAR16 FontName[1];\r
} EFI_FONT_INFO;\r
\r
/**\r
@retval EFI_OUT_OF_RESOURCES Unable to allocate an output\r
buffer for RowInfoArray or Blt.\r
\r
- @retval EFI_INVALID_PARAMETER The String or Blt or Height or\r
- Width was NULL.\r
+ @retval EFI_INVALID_PARAMETER The String or Blt.\r
+ @retval EFI_INVALID_PARAMETER Flags were invalid combination..\r
\r
- \r
**/\r
typedef\r
EFI_STATUS\r
\r
@retval EFI_INVALID_PARAMETER The String or Blt or Height or\r
Width was NULL.\r
+ @retval EFI_INVALID_PARAMETER The Blt or PackageList was NULL.\r
+ @retval EFI_INVALID_PARAMETER Flags were invalid combination.\r
+ @retval EFI_NOT_FOUND The specified PackageList is not in the Database or the stringid is not \r
+ in the specified PackageList. \r
\r
**/\r
typedef\r
to NULL if there are no more matching fonts.\r
\r
@param StringInfoIn Upon entry, points to the font to return\r
- information about.\r
+ information about. If NULL, then the information about the system default \r
+ font will be returned.\r
\r
@param StringInfoOut Upon return, contains the matching\r
font's information. If NULL, then no\r
\r
@retval EFI_NOT_FOUND No matching font was found.\r
\r
- @retval EFI_INVALID_PARAMETER FontHandle is NULL or\r
- StringInfoIn is NULL\r
+ @retval EFI_INVALID_PARAMETER StringInfoIn->FontInfoMask is an invalid combination.\r
+\r
+ @retval EFI_OUT_OF_RESOURCES There were insufficient resources to complete the request.\r
\r
**/\r
typedef\r
(EFIAPI *EFI_HII_GET_FONT_INFO) (\r
IN CONST EFI_HII_FONT_PROTOCOL *This,\r
IN OUT EFI_FONT_HANDLE *FontHandle,\r
- IN CONST EFI_FONT_DISPLAY_INFO *StringInfoIn,\r
+ IN CONST EFI_FONT_DISPLAY_INFO *StringInfoIn, OPTIONAL\r
OUT EFI_FONT_DISPLAY_INFO **StringInfoOut,\r
IN CONST EFI_STRING String OPTIONAL\r
);\r
/** @file\r
The file provides services to access to images in the images database.\r
\r
- Copyright (c) 2006 - 2007, Intel Corporation\r
+ Copyright (c) 2006 - 2008, Intel Corporation\r
All rights reserved. This program and the accompanying materials \r
are licensed and made available under the terms and conditions of the BSD License \r
which accompanies this distribution. The full text of the license may be found at \r
UINT32 Flags;\r
UINT16 Width;\r
UINT16 Height;\r
- EFI_GRAPHICS_OUTPUT_BLT_PIXEL Bitmap[1];\r
+ EFI_GRAPHICS_OUTPUT_BLT_PIXEL *Bitmap;\r
} EFI_IMAGE_INPUT;\r
\r
\r
\r
@param Image Points to the new image.\r
\r
- @param ImageSize On entry, points to the size of the buffer\r
- pointed to by Image, in bytes. On return,\r
- points to the length of the image, in bytes.\r
- \r
- \r
@retval EFI_SUCCESS The image was returned successfully.\r
- \r
+ The specified PackageList is not in the database.\r
@retval EFI_NOT_FOUND The image specified by ImageId is not\r
available.\r
\r
- @retval EFI_BUFFER_TOO_SMALL The buffer specified by\r
- ImageLength is too small to hold\r
- the image.\r
- \r
@retval EFI_INVALID_PARAMETER The Image or Langugae was NULL.\r
+ @retval EFI_OUT_OF_RESOURCES The bitmap could not be retrieved because there was not\r
+ enough memory.\r
\r
\r
**/\r
IN CONST EFI_HII_IMAGE_PROTOCOL *This,\r
IN EFI_HII_HANDLE PackageList,\r
IN EFI_IMAGE_ID ImageId,\r
- OUT EFI_IMAGE_INPUT *Image,\r
- OUT UINTN *ImageSize\r
+ OUT EFI_IMAGE_INPUT *Image\r
);\r
\r
/**\r
@retval EFI_SUCCESS The image was successfully updated.\r
\r
@retval EFI_NOT_FOUND The image specified by ImageId is not\r
- in the database.\r
+ in the database.\r
+ The specified PackageList is not in the database. \r
\r
@retval EFI_INVALID_PARAMETER The Image or Language was\r
NULL.\r
#define EFI_HII_DRAW_FLAG_CLIP 0x00000001\r
#define EFI_HII_DRAW_FLAG_TRANSPARENT 0x00000030\r
#define EFI_HII_DRAW_FLAG_DEFAULT 0x00000000\r
-#define EFI_HII_DRAW_FLAG_FORCE_TRANS 0x00000001\r
-#define EFI_HII_DRAW_FLAG_FORCE_OPAQUE 0x00000002\r
+#define EFI_HII_DRAW_FLAG_FORCE_TRANS 0x00000010\r
+#define EFI_HII_DRAW_FLAG_FORCE_OPAQUE 0x00000020\r
#define EFI_HII_DIRECT_TO_SCREEN 0x00000080\r
\r
\r
@retval EFI_OUT_OF_RESOURCES Unable to allocate an output\r
buffer for RowInfoArray or Blt.\r
\r
- @retval EFI_INVALID_PARAMETER The Image or Blt or Height or\r
- Width was NULL.\r
+ @retval EFI_NOT_FOUND The image specified by ImageId is not in the database. \r
+ The specified PackageList is not in the database. \r
+ @retval EFI_INVALID_PARAMETER The Blt was NULL. \r
\r
**/\r
typedef\r
/** @file\r
The file provides services to manipulate string data.\r
\r
- Copyright (c) 2006 - 2007, Intel Corporation\r
+ Copyright (c) 2006 - 2008, Intel Corporation\r
All rights reserved. This program and the accompanying materials \r
are licensed and made available under the terms and conditions of the BSD License \r
which accompanies this distribution. The full text of the license may be found at \r
points to the length of the string, in\r
bytes.\r
\r
- @param StringFontInfo Points to the string's font\r
- information or NULL if the string font\r
- information is not desired.\r
+ @param StringFontInfo Points to a buffer that will be callee allocated and will \r
+ have the string's font information into this buffer. \r
+ The caller is responsible for freeing this buffer. \r
+ If the parameter is NULL a buffer will not be allocated \r
+ and the string font information will not be returned.\r
\r
@retval EFI_SUCCESS The string was returned successfully.\r
\r
@retval EFI_NOT_FOUND The string specified by StringId is not\r
- available.\r
+ available. The specified PackageList is not in the database.\r
\r
@retval EFI_INVALID_LANGUAGE The string specified by StringId\r
is available but not in the\r
@retval EFI_SUCCESS The string was successfully updated.\r
\r
@retval EFI_NOT_FOUND The string specified by StringId is not\r
- in the database.\r
+ in the database. The specified PackageList is not in the database.\r
\r
@retval EFI_INVALID_PARAMETER The String or Language was NULL.\r
\r
updated to contain the required\r
size.\r
\r
- @retval EFI_INVALID_PARAMETER Languages is NULL.\r
+ @retval EFI_INVALID_PARAMETER Languages or LanguagesSize is NULL.\r
+ @retval EFI_NOT_FOUND The specified PackageList is not in the database.\r
\r
\r
**/\r
\r
@retval EFI_INVALID_PARAMETER FirstLanguage is NULL or\r
SecondLanguage is NULL.\r
+ @retval EFI_NOT_FOUND The specified PackageList is not in the database.\r
\r
**/\r
typedef\r
\r
Defines data types and constants introduced in UEFI.\r
\r
- Copyright (c) 2006 - 2007, Intel Corporation\r
+ Copyright (c) 2006 - 2008, Intel Corporation\r
All rights reserved. This program and the accompanying materials\r
are licensed and made available under the terms and conditions of the BSD License\r
which accompanies this distribution. The full text of the license may be found at\r
#define EFI_CRC_ERROR RETURN_CRC_ERROR \r
#define EFI_END_OF_MEDIA RETURN_END_OF_MEDIA\r
#define EFI_END_OF_FILE RETURN_END_OF_FILE\r
+#define EFI_INVALID_LANGUAGE RETURN_INVALID_LANGUAGE\r
\r
#define EFI_WARN_UNKNOWN_GLYPH RETURN_WARN_UNKNOWN_GLYPH \r
#define EFI_WARN_DELETE_FAILURE RETURN_WARN_DELETE_FAILURE \r
IFR is primarily consumed by the EFI presentation engine, and produced by EFI\r
internal application and drivers as well as all add-in card option-ROM drivers\r
\r
- Copyright (c) 2006 - 2007, Intel Corporation \r
+ Copyright (c) 2006 - 2008, Intel Corporation \r
All rights reserved. This program and the accompanying materials \r
are licensed and made available under the terms and conditions of the BSD License \r
which accompanies this distribution. The full text of the license may be found at \r
// Font Package\r
//\r
\r
+#define EFI_HII_FONT_STYLE_NORMAL 0x00000000\r
#define EFI_HII_FONT_STYLE_BOLD 0x00000001\r
#define EFI_HII_FONT_STYLE_ITALIC 0x00000002\r
#define EFI_HII_FONT_STYLE_EMBOSS 0x00010000\r
\r
typedef struct _EFI_IFR_VARSTORE_EFI {\r
EFI_IFR_OP_HEADER Header;\r
- UINT16 VarStoreId;\r
+ EFI_VARSTORE_ID VarStoreId;\r
EFI_GUID Guid;\r
UINT32 Attributes;\r
} EFI_IFR_VARSTORE_EFI;\r
\r
typedef struct _EFI_IFR_VARSTORE_NAME_VALUE {\r
EFI_IFR_OP_HEADER Header;\r
- UINT16 VarStoreId;\r
+ EFI_VARSTORE_ID VarStoreId;\r
EFI_GUID Guid;\r
} EFI_IFR_VARSTORE_NAME_VALUE;\r
\r
EfiKeyB8,\r
EfiKeyB9,\r
EfiKeyB10,\r
- EfiKeyRshift,\r
+ EfiKeyRShift,\r
EfiKeyUpArrow,\r
EfiKeyOne,\r
EfiKeyTwo,\r
// EFI_HII_KEYBOARD_LAYOUT Layout[];\r
} EFI_HII_KEYBOARD_PACKAGE_HDR;\r
\r
-typedef struct {\r
- CHAR16 Language[3];\r
- CHAR16 Space;\r
- CHAR16 DescriptionString[1];\r
-} EFI_DESCRIPTION_STRING;\r
+//typedef struct {\r
+// CHAR16 Language[]; // RFC4646 Language Code\r
+// CHAR16 Space;\r
+// CHAR16 DescriptionString[];\r
+//} EFI_DESCRIPTION_STRING;\r
\r
-typedef struct {\r
- UINT16 DescriptionCount;\r
- EFI_DESCRIPTION_STRING DescriptionString[1];\r
-} EFI_DESCRIPTION_STRING_BUNDLE;\r
+//typedef struct {\r
+// UINT16 DescriptionCount;\r
+// EFI_DESCRIPTION_STRING DescriptionString[];\r
+//} EFI_DESCRIPTION_STRING_BUNDLE;\r
\r
//\r
// Modifier values\r
#define EFI_LEFT_SHIFT_MODIFIER 0x000C\r
#define EFI_RIGHT_SHIFT_MODIFIER 0x000D\r
#define EFI_CAPS_LOCK_MODIFIER 0x000E\r
-#define EFI_NUM_LOCK _MODIFIER 0x000F\r
+#define EFI_NUM_LOCK_MODIFIER 0x000F\r
#define EFI_LEFT_ARROW_MODIFIER 0x0010\r
#define EFI_RIGHT_ARROW_MODIFIER 0x0011\r
#define EFI_DOWN_ARROW_MODIFIER 0x0012\r
#define EFI_PAUSE_MODIFIER 0x0025\r
#define EFI_BREAK_MODIFIER 0x0026\r
\r
+#define EFI_LEFT_LOGO_MODIFIER 0x0027\r
+#define EFI_RIGHT_LOGO_MODIFIER 0x0028\r
+#define EFI_MENU_MODIFIER 0x0029\r
+\r
#pragma pack()\r
\r
\r
if (LanguageString == NULL) {\r
return NULL;\r
}\r
+\r
+ LocateHiiProtocols ();\r
\r
Status = mHiiStringProt->GetLanguages (mHiiStringProt, HiiHandle, LanguageString, &BufferSize);\r
\r
if (LanguageString == NULL) {\r
return NULL;\r
}\r
+\r
+ LocateHiiProtocols ();\r
+ \r
Status = mHiiStringProt->GetSecondaryLanguages (mHiiStringProt, HiiHandle, FirstLanguage, LanguageString, &BufferSize);\r
\r
if (Status == EFI_BUFFER_TOO_SMALL) {\r
\r
CONST EFI_HII_DATABASE_PROTOCOL *mHiiDatabaseProt;\r
CONST EFI_HII_STRING_PROTOCOL *mHiiStringProt;\r
+BOOLEAN mHiiProtocolsInitialized = FALSE;\r
+\r
\r
/**\r
- The constructor function of Hii Library.\r
- \r
- The constructor function caches the value of default HII protocol instances.\r
\r
- @param ImageHandle The firmware allocated handle for the EFI image.\r
- @param SystemTable A pointer to the EFI System Table.\r
- \r
- @retval EFI_SUCCESS The constructor always returns EFI_SUCCESS.\r
+ This function locate Hii relative protocols for later usage.\r
+\r
+ @param VOID\r
+\r
+ @retval VOID\r
\r
**/\r
-EFI_STATUS\r
-EFIAPI\r
-UefiHiiLibConstructor (\r
- IN EFI_HANDLE ImageHandle,\r
- IN EFI_SYSTEM_TABLE *SystemTable\r
+VOID\r
+LocateHiiProtocols (\r
+ VOID\r
)\r
{\r
- EFI_STATUS Status;\r
- \r
- Status = gBS->LocateProtocol (\r
- &gEfiHiiDatabaseProtocolGuid,\r
- NULL,\r
- (VOID **) &mHiiDatabaseProt\r
- );\r
+ EFI_STATUS Status;\r
+\r
+ if (mHiiProtocolsInitialized) {\r
+ return;\r
+ }\r
+\r
+ Status = gBS->LocateProtocol (&gEfiHiiDatabaseProtocolGuid, NULL, (VOID **) &mHiiDatabaseProt);\r
ASSERT_EFI_ERROR (Status);\r
- ASSERT (mHiiDatabaseProt != NULL);\r
\r
- Status = gBS->LocateProtocol (\r
- &gEfiHiiStringProtocolGuid,\r
- NULL,\r
- (VOID **) &mHiiStringProt\r
- );\r
+ Status = gBS->LocateProtocol (&gEfiHiiStringProtocolGuid, NULL, (VOID **) &mHiiStringProt);\r
ASSERT_EFI_ERROR (Status);\r
- ASSERT (mHiiStringProt != NULL);\r
\r
- return EFI_SUCCESS;\r
+ mHiiProtocolsInitialized = TRUE;\r
}\r
\r
\r
\r
ASSERT (HiiHandle != NULL);\r
\r
+ LocateHiiProtocols ();\r
+\r
VA_START (Args, HiiHandle);\r
PackageListHeader = InternalHiiLibPreparePackages (NumberOfPackages, GuidId, Args);\r
\r
)\r
{\r
EFI_STATUS Status;\r
-\r
ASSERT (HiiHandle != NULL);\r
+\r
+ LocateHiiProtocols ();\r
+\r
Status = mHiiDatabaseProt->RemovePackageList (mHiiDatabaseProt, HiiHandle);\r
ASSERT_EFI_ERROR (Status);\r
}\r
\r
BufferLength = 0;\r
\r
+ LocateHiiProtocols ();\r
+\r
//\r
// Try to find the actual buffer size for HiiHandle Buffer.\r
//\r
//\r
BufferSize = 0;\r
HiiPackageList = NULL;\r
+\r
+ LocateHiiProtocols ();\r
+\r
Status = mHiiDatabaseProt->ExportPackageLists (mHiiDatabaseProt, Handle, &BufferSize, HiiPackageList);\r
ASSERT (Status != EFI_NOT_FOUND);\r
\r
return NULL;\r
}\r
\r
+ LocateHiiProtocols ();\r
+\r
//\r
// Retrieve all Hii Handles from HII database\r
//\r
\r
HiiPackageList = NULL;\r
BufferSize = 0;\r
+\r
+ LocateHiiProtocols ();\r
+\r
Status = mHiiDatabaseProt->ExportPackageLists (\r
mHiiDatabaseProt,\r
HiiHandle,\r
EDK_RELEASE_VERSION = 0x00020000\r
EFI_SPECIFICATION_VERSION = 0x0002000A\r
\r
- CONSTRUCTOR = UefiHiiLibConstructor\r
-\r
#\r
# VALID_ARCHITECTURES = IA32 X64 IPF EBC\r
#\r
[Guids] \r
gEfiGlobalVariableGuid \r
\r
-[Depex]\r
- gEfiHiiDatabaseProtocolGuid AND gEfiHiiStringProtocolGuid\r
-\r
[Pcd]\r
gEfiMdePkgTokenSpaceGuid.PcdUefiVariableDefaultPlatformLang
\ No newline at end of file
#define HII_LIB_DEFAULT_STRING_SIZE 0x200\r
\r
\r
-extern CONST EFI_HII_DATABASE_PROTOCOL *mHiiDatabaseProt;\r
-extern CONST EFI_HII_STRING_PROTOCOL *mHiiStringProt;\r
+extern CONST EFI_HII_DATABASE_PROTOCOL *mHiiDatabaseProt;\r
+extern CONST EFI_HII_STRING_PROTOCOL *mHiiStringProt;\r
+extern BOOLEAN mHiiProtocolsInitialized;\r
+\r
\r
BOOLEAN\r
IsHiiHandleRegistered (\r
)\r
;\r
\r
+VOID\r
+LocateHiiProtocols (\r
+ VOID\r
+ )\r
+;\r
+\r
#endif\r
EDK_RELEASE_VERSION = 0x00020000\r
EFI_SPECIFICATION_VERSION = 0x00020000\r
\r
- CONSTRUCTOR = IfrSupportLibConstructor\r
-\r
#\r
# The following information is for reference only and not required by the build tools.\r
#\r
#\r
\r
[Sources.common]\r
- UefiIfrCommon.c\r
UefiIfrForm.c\r
UefiIfrLibraryInternal.h\r
UefiIfrOpCodeCreation.c\r
gEfiHiiConfigRoutingProtocolGuid\r
gEfiFormBrowser2ProtocolGuid \r
\r
-[Depex]\r
- gEfiHiiDatabaseProtocolGuid AND gEfiHiiStringProtocolGuid\r
-\r
[Pcd]\r
gEfiMdePkgTokenSpaceGuid.PcdUefiVariableDefaultPlatformLang\r
/** @file
-Copyright (c) 2007, Intel Corporation
+Copyright (c) 2007- 2008, Intel Corporation
All rights reserved. This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License
which accompanies this distribution. The full text of the license may be found at
UINT8 Temp;
UINTN SwapCount;
- SwapCount = (BufferSize - 1) / 2;
+ SwapCount = BufferSize / 2;
for (Index = 0; Index < SwapCount; Index++) {
Temp = Buffer[Index];
Buffer[Index] = Buffer[BufferSize - 1 - Index];
}
}
+/**
+ Converts the unicode character of the string from uppercase to lowercase.
+
+ @param Str String to be converted
+
+ @retval VOID
+
+**/
+VOID
+ToLower (
+ IN OUT CHAR16 *Str
+ )
+{
+ CHAR16 *Ptr;
+
+ for (Ptr = Str; *Ptr != L'\0'; Ptr++) {
+ if (*Ptr >= L'A' && *Ptr <= L'Z') {
+ *Ptr = (CHAR16) (*Ptr - L'A' + L'a');
+ }
+ }
+}
+
/**
Converts binary buffer to Unicode string in reversed byte order from BufToHexString().
NewBuffer = AllocateCopyPool (BufferSize, Buffer);
SwapBuffer (NewBuffer, BufferSize);
- StrBufferLen = (BufferSize + 1) * sizeof (CHAR16);
+ StrBufferLen = BufferSize * sizeof (CHAR16) + 1;
Status = BufToHexString (Str, &StrBufferLen, NewBuffer, BufferSize);
gBS->FreePool (NewBuffer);
+ //
+ // Convert the uppercase to lowercase since <HexAf> is defined in lowercase format.
+ //
+ ToLower (Str);
return Status;
}
return Status;
}
+/**
+ Convert binary representation Config string (e.g. "0041004200430044") to the
+ original string (e.g. "ABCD"). Config string appears in <ConfigHdr> (i.e.
+ "&NAME=<string>"), or Name/Value pair in <ConfigBody> (i.e. "label=<string>").
+
+ @param UnicodeString Original Unicode string.
+ @param StrBufferLen On input: Length in bytes of buffer to hold the Unicode string.
+ Includes tailing '\0' character.
+ On output:
+ If return EFI_SUCCESS, containing length of Unicode string buffer.
+ If return EFI_BUFFER_TOO_SMALL, containg length of string buffer desired.
+ @param ConfigString Binary representation of Unicode String, <string> := (<HexCh>4)+
+
+ @retval EFI_SUCCESS Routine success.
+ @retval EFI_BUFFER_TOO_SMALL The string buffer is too small.
+
+**/
+EFI_STATUS
+ConfigStringToUnicode (
+ IN OUT CHAR16 *UnicodeString,
+ IN OUT UINTN *StrBufferLen,
+ IN CHAR16 *ConfigString
+ )
+{
+ UINTN Index;
+ UINTN Len;
+ UINTN BufferSize;
+ CHAR16 BackupChar;
+
+ Len = StrLen (ConfigString) / 4;
+ BufferSize = (Len + 1) * sizeof (CHAR16);
+
+ if (*StrBufferLen < BufferSize) {
+ *StrBufferLen = BufferSize;
+ return EFI_BUFFER_TOO_SMALL;
+ }
+
+ *StrBufferLen = BufferSize;
+
+ for (Index = 0; Index < Len; Index++) {
+ BackupChar = ConfigString[4];
+ ConfigString[4] = L'\0';
+
+ HexStringToBuf ((UINT8 *) UnicodeString, &BufferSize, ConfigString, NULL);
+
+ ConfigString[4] = BackupChar;
+
+ ConfigString += 4;
+ UnicodeString += 1;
+ }
+
+ //
+ // Add tailing '\0' character
+ //
+ *UnicodeString = L'\0';
+
+ return EFI_SUCCESS;
+}
+
+/**
+ Convert Unicode string to binary representation Config string, e.g.
+ "ABCD" => "0041004200430044". Config string appears in <ConfigHdr> (i.e.
+ "&NAME=<string>"), or Name/Value pair in <ConfigBody> (i.e. "label=<string>").
+
+ @param ConfigString Binary representation of Unicode String, <string> := (<HexCh>4)+
+ @param StrBufferLen On input: Length in bytes of buffer to hold the Unicode string.
+ Includes tailing '\0' character.
+ On output:
+ If return EFI_SUCCESS, containing length of Unicode string buffer.
+ If return EFI_BUFFER_TOO_SMALL, containg length of string buffer desired.
+ @param UnicodeString Original Unicode string.
+
+ @retval EFI_SUCCESS Routine success.
+ @retval EFI_BUFFER_TOO_SMALL The string buffer is too small.
+
+**/
+EFI_STATUS
+UnicodeToConfigString (
+ IN OUT CHAR16 *ConfigString,
+ IN OUT UINTN *StrBufferLen,
+ IN CHAR16 *UnicodeString
+ )
+{
+ UINTN Index;
+ UINTN Len;
+ UINTN BufferSize;
+ CHAR16 *String;
+
+ Len = StrLen (UnicodeString);
+ BufferSize = (Len * 4 + 1) * sizeof (CHAR16);
+
+ if (*StrBufferLen < BufferSize) {
+ *StrBufferLen = BufferSize;
+ return EFI_BUFFER_TOO_SMALL;
+ }
+
+ *StrBufferLen = BufferSize;
+ String = ConfigString;
+
+ for (Index = 0; Index < Len; Index++) {
+ BufToHexString (ConfigString, &BufferSize, (UINT8 *) UnicodeString, 2);
+
+ ConfigString += 4;
+ UnicodeString += 1;
+ }
+
+ //
+ // Add tailing '\0' character
+ //
+ *ConfigString = L'\0';
+
+ //
+ // Convert the uppercase to lowercase since <HexAf> is defined in lowercase format.
+ //
+ ToLower (String);
+ return EFI_SUCCESS;
+}
/**
Construct <ConfigHdr> using routing information GUID/NAME/PATH.
DevicePathSize = GetDevicePathSize (DevicePath);
//
- // GUID=<HexCh>32&NAME=<Alpha>NameStrLen&PATH=<HexChar>DevicePathStrLen <NULL>
- // | 5 | 32 | 6 | NameStrLen | 6 | DevicePathStrLen |
+ // GUID=<HexCh>32&NAME=<Char>NameStrLen&PATH=<HexChar>DevicePathStrLen <NULL>
+ // | 5 | 32 | 6 | NameStrLen*4 | 6 | DevicePathStrLen | 1 |
//
- BufferSize = (5 + 32 + 6 + NameStrLen + 6 + DevicePathSize * 2 + 1) * sizeof (CHAR16);
+ BufferSize = (5 + 32 + 6 + NameStrLen * 4 + 6 + DevicePathSize * 2 + 1) * sizeof (CHAR16);
if (*StrBufferLen < BufferSize) {
*StrBufferLen = BufferSize;
return EFI_BUFFER_TOO_SMALL;
BufferToHexString (StrPtr, (UINT8 *) Guid, sizeof (EFI_GUID));
StrPtr += 32;
+ //
+ // Convert name string, e.g. name "ABCD" => "&NAME=0041004200430044"
+ //
StrCpy (StrPtr, L"&NAME=");
StrPtr += 6;
if (Name != NULL) {
- StrCpy (StrPtr, Name);
- StrPtr += NameStrLen;
+ BufferSize = (NameStrLen * 4 + 1) * sizeof (CHAR16);
+ UnicodeToConfigString (StrPtr, &BufferSize, Name);
+ StrPtr += (NameStrLen * 4);
}
StrCpy (StrPtr, L"&PATH=");
projects / mirror_edk2.git / commitdiff