/** @file\r
Private structures definitions in HiiDatabase.\r
\r
-Copyright (c) 2007 - 2016, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2007 - 2018, Intel Corporation. All rights reserved.<BR>\r
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
#include <Protocol/DevicePath.h>\r
#include <Protocol/HiiFont.h>\r
#include <Protocol/HiiImage.h>\r
+#include <Protocol/HiiImageEx.h>\r
+#include <Protocol/HiiImageDecoder.h>\r
#include <Protocol/HiiString.h>\r
#include <Protocol/HiiDatabase.h>\r
#include <Protocol/HiiConfigRouting.h>\r
\r
#include <Guid/HiiKeyBoardLayout.h>\r
#include <Guid/GlobalVariable.h>\r
-\r
+#include <Guid/MdeModuleHii.h>\r
+#include <Guid/VariableFormat.h>\r
+#include <Guid/PcdDataBaseSignatureGuid.h>\r
\r
#include <Library/DebugLib.h>\r
#include <Library/BaseMemoryLib.h>\r
//\r
// BASE_CR (a, IFR_DEFAULT_VALUE_DATA, Entry) to get the whole structure.\r
\r
+typedef struct {\r
+ LIST_ENTRY Entry; // Link to VarStorage Default Data\r
+ UINT16 DefaultId;\r
+ VARIABLE_STORE_HEADER *VariableStorage;\r
+} VARSTORAGE_DEFAULT_DATA;\r
+\r
typedef struct {\r
LIST_ENTRY Entry; // Link to VarStorage\r
EFI_GUID Guid;\r
LIST_ENTRY Entry; // Link to Block array\r
UINT16 Offset;\r
UINT16 Width;\r
+ UINT16 BitOffset;\r
+ UINT16 BitWidth;\r
EFI_QUESTION_ID QuestionId;\r
UINT8 OpCode;\r
UINT8 Scope;\r
LIST_ENTRY DefaultValueEntry; // Link to its default value array\r
CHAR16 *Name;\r
+ BOOLEAN IsBitVar;\r
} IFR_BLOCK_DATA;\r
\r
//\r
DefaultValueFromDefault = 0, // Get from the minimum or first one when not set default value.\r
DefaultValueFromOtherDefault, // Get default vale from other default when no default(When other\r
// defaults are more than one, use the default with smallest default id).\r
- DefaultValueFromFlag, // Get default value from the defalut flag.\r
+ DefaultValueFromFlag, // Get default value from the default flag.\r
DefaultValueFromOpcode // Get default value from default opcode, highest priority.\r
} DEFAULT_VALUE_TYPE;\r
\r
EFI_HII_IMAGE_PACKAGE_HDR ImagePkgHdr;\r
UINT32 ImageBlockSize;\r
UINT32 PaletteInfoSize;\r
- UINT8 *ImageBlock;\r
+ EFI_HII_IMAGE_BLOCK *ImageBlock;\r
UINT8 *PaletteBlock;\r
} HII_IMAGE_PACKAGE_INSTANCE;\r
\r
//\r
-// Keyboard Layout Pacakge definitions\r
+// Keyboard Layout Package definitions\r
//\r
#define HII_KB_LAYOUT_PACKAGE_SIGNATURE SIGNATURE_32 ('h','k','l','p')\r
typedef struct _HII_KEYBOARD_LAYOUT_PACKAGE_INSTANCE {\r
LIST_ENTRY DatabaseNotifyList;\r
EFI_HII_FONT_PROTOCOL HiiFont;\r
EFI_HII_IMAGE_PROTOCOL HiiImage;\r
+ EFI_HII_IMAGE_EX_PROTOCOL HiiImageEx;\r
EFI_HII_STRING_PROTOCOL HiiString;\r
EFI_HII_DATABASE_PROTOCOL HiiDatabase;\r
EFI_HII_CONFIG_ROUTING_PROTOCOL ConfigRouting;\r
HII_DATABASE_PRIVATE_DATA_SIGNATURE \\r
)\r
\r
+#define HII_IMAGE_EX_DATABASE_PRIVATE_DATA_FROM_THIS(a) \\r
+ CR (a, \\r
+ HII_DATABASE_PRIVATE_DATA, \\r
+ HiiImageEx, \\r
+ HII_DATABASE_PRIVATE_DATA_SIGNATURE \\r
+ )\r
+\r
#define HII_STRING_DATABASE_PRIVATE_DATA_FROM_THIS(a) \\r
CR (a, \\r
HII_DATABASE_PRIVATE_DATA, \\r
\r
@param BufferLen The length of the Buffer in bytes.\r
\r
- @param Buffer Points to a buffer which will be converted to be the \r
+ @param Buffer Points to a buffer which will be converted to be the\r
content of the generated string.\r
\r
- @param Flag If 1, the buffer contains data for the value of GUID or PATH stored in \r
+ @param Flag If 1, the buffer contains data for the value of GUID or PATH stored in\r
UINT8 *; if 2, the buffer contains unicode string for the value of NAME;\r
if 3, the buffer contains other data.\r
\r
@param FontHandle On entry, Points to the font handle returned by a\r
previous call to GetFontInfo() or NULL to start\r
with the first font.\r
- @param GlobalFontInfo If not NULL, output the corresponding globa font\r
+ @param GlobalFontInfo If not NULL, output the corresponding global font\r
info.\r
\r
@retval TRUE Existed\r
/**\r
\r
This function invokes the matching registered function.\r
- \r
+\r
@param Private HII Database driver private structure.\r
@param NotifyType The type of change concerning the database.\r
@param PackageInstance Points to the package referred to by the notification.\r
@param PackageType Package type\r
@param Handle The handle of the package list which contains the specified package.\r
- \r
- @retval EFI_SUCCESS Already checked all registered function and invoked \r
+\r
+ @retval EFI_SUCCESS Already checked all registered function and invoked\r
if matched.\r
@retval EFI_INVALID_PARAMETER Any input parameter is not valid.\r
- \r
+\r
**/\r
EFI_STATUS\r
InvokeRegisteredFunction (\r
- IN HII_DATABASE_PRIVATE_DATA *Private, \r
+ IN HII_DATABASE_PRIVATE_DATA *Private,\r
IN EFI_HII_DATABASE_NOTIFY_TYPE NotifyType,\r
IN VOID *PackageInstance,\r
IN UINT8 PackageType,\r
/**\r
Parse all string blocks to find a String block specified by StringId.\r
If StringId = (EFI_STRING_ID) (-1), find out all EFI_HII_SIBT_FONT blocks\r
- within this string package and backup its information. If LastStringId is \r
+ within this string package and backup its information. If LastStringId is\r
specified, the string id of last string block will also be output.\r
If StringId = 0, output the string id of last string block (EFI_HII_SIBT_STRING).\r
\r
@param CharValue Unicode character value, which identifies a glyph\r
block.\r
@param GlyphBuffer Output the corresponding bitmap data of the found\r
- block. It is the caller's responsiblity to free\r
+ block. It is the caller's responsibility to free\r
this buffer.\r
@param Cell Output cell information of the encoded bitmap.\r
@param GlyphBufferLen If not NULL, output the length of GlyphBuffer.\r
RowInfoArray or Blt.\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
+ @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
EFI_STATUS\r
@param StringInfoOut Upon return, contains the matching font's information.\r
If NULL, then no information is returned. This buffer\r
is allocated with a call to the Boot Service AllocatePool().\r
- It is the caller's responsibility to call the Boot \r
+ It is the caller's responsibility to call the Boot\r
Service FreePool() when the caller no longer requires\r
the contents of StringInfoOut.\r
@param String Points to the string which will be tested to\r
// EFI_HII_IMAGE_PROTOCOL interfaces\r
//\r
\r
+/**\r
+ Get the image id of last image block: EFI_HII_IIBT_END_BLOCK when input\r
+ ImageId is zero, otherwise return the address of the\r
+ corresponding image block with identifier specified by ImageId.\r
+\r
+ This is a internal function.\r
+\r
+ @param ImageBlocks Points to the beginning of a series of image blocks stored in order.\r
+ @param ImageId If input ImageId is 0, output the image id of the EFI_HII_IIBT_END_BLOCK;\r
+ else use this id to find its corresponding image block address.\r
+\r
+ @return The image block address when input ImageId is not zero; otherwise return NULL.\r
+\r
+**/\r
+EFI_HII_IMAGE_BLOCK *\r
+GetImageIdOrAddress (\r
+ IN EFI_HII_IMAGE_BLOCK *ImageBlocks,\r
+ IN OUT EFI_IMAGE_ID *ImageId\r
+ );\r
+\r
+/**\r
+ Return the HII package list identified by PackageList HII handle.\r
+\r
+ @param Database Pointer to HII database list header.\r
+ @param PackageList HII handle of the package list to locate.\r
+\r
+ @retval The HII package list instance.\r
+**/\r
+HII_DATABASE_PACKAGE_LIST_INSTANCE *\r
+LocatePackageList (\r
+ IN LIST_ENTRY *Database,\r
+ IN EFI_HII_HANDLE PackageList\r
+ );\r
+\r
+/**\r
+ This function retrieves the image specified by ImageId which is associated with\r
+ the specified PackageList and copies it into the buffer specified by Image.\r
+\r
+ @param Database A pointer to the database list header.\r
+ @param PackageList Handle of the package list where this image will\r
+ be searched.\r
+ @param ImageId The image's id,, which is unique within\r
+ PackageList.\r
+ @param Image Points to the image.\r
+ @param BitmapOnly TRUE to only return the bitmap type image.\r
+ FALSE to locate image decoder instance to decode image.\r
+\r
+ @retval EFI_SUCCESS The new image was returned successfully.\r
+ @retval EFI_NOT_FOUND The image specified by ImageId is not in the\r
+ database. The specified PackageList is not in the database.\r
+ @retval EFI_BUFFER_TOO_SMALL The buffer specified by ImageSize is too small to\r
+ hold the image.\r
+ @retval EFI_INVALID_PARAMETER The Image or ImageSize was NULL.\r
+ @retval EFI_OUT_OF_RESOURCES The bitmap could not be retrieved because there was not\r
+ enough memory.\r
+**/\r
+EFI_STATUS\r
+IGetImage (\r
+ IN LIST_ENTRY *Database,\r
+ IN EFI_HII_HANDLE PackageList,\r
+ IN EFI_IMAGE_ID ImageId,\r
+ OUT EFI_IMAGE_INPUT *Image,\r
+ IN BOOLEAN BitmapOnly\r
+ );\r
+\r
+/**\r
+ Return the first HII image decoder instance which supports the DecoderName.\r
+\r
+ @param BlockType The image block type.\r
+\r
+ @retval Pointer to the HII image decoder instance.\r
+**/\r
+EFI_HII_IMAGE_DECODER_PROTOCOL *\r
+LocateHiiImageDecoder (\r
+ UINT8 BlockType\r
+ );\r
\r
/**\r
This function adds the image Image to the group of images owned by PackageList, and returns\r
@retval EFI_SUCCESS The image was successfully drawn.\r
@retval EFI_OUT_OF_RESOURCES Unable to allocate an output buffer for Blt.\r
@retval EFI_INVALID_PARAMETER The Blt was NULL.\r
- @retval EFI_NOT_FOUND The image specified by ImageId is not in the database. \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
\r
**/\r
IN OUT EFI_IMAGE_OUTPUT **Blt,\r
IN UINTN BltX,\r
IN UINTN BltY\r
- )\r
+ );\r
\r
-;\r
+/**\r
+ The prototype of this extension function is the same with EFI_HII_IMAGE_PROTOCOL.NewImage().\r
+ This protocol invokes EFI_HII_IMAGE_PROTOCOL.NewImage() implicitly.\r
+\r
+ @param This A pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance.\r
+ @param PackageList Handle of the package list where this image will\r
+ be added.\r
+ @param ImageId On return, contains the new image id, which is\r
+ unique within PackageList.\r
+ @param Image Points to the image.\r
+\r
+ @retval EFI_SUCCESS The new image was added successfully.\r
+ @retval EFI_NOT_FOUND The PackageList could not be found.\r
+ @retval EFI_OUT_OF_RESOURCES Could not add the image due to lack of resources.\r
+ @retval EFI_INVALID_PARAMETER Image is NULL or ImageId is NULL.\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+HiiNewImageEx (\r
+ IN CONST EFI_HII_IMAGE_EX_PROTOCOL *This,\r
+ IN EFI_HII_HANDLE PackageList,\r
+ OUT EFI_IMAGE_ID *ImageId,\r
+ IN CONST EFI_IMAGE_INPUT *Image\r
+ );\r
+\r
+/**\r
+ Return the information about the image, associated with the package list.\r
+ The prototype of this extension function is the same with EFI_HII_IMAGE_PROTOCOL.GetImage().\r
+\r
+ This function is similar to EFI_HII_IMAGE_PROTOCOL.GetImage(). The difference is that\r
+ this function will locate all EFI_HII_IMAGE_DECODER_PROTOCOL instances installed in the\r
+ system if the decoder of the certain image type is not supported by the\r
+ EFI_HII_IMAGE_EX_PROTOCOL. The function will attempt to decode the image to the\r
+ EFI_IMAGE_INPUT using the first EFI_HII_IMAGE_DECODER_PROTOCOL instance that\r
+ supports the requested image type.\r
+\r
+ @param This A pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance.\r
+ @param PackageList The package list in the HII database to search for the\r
+ specified image.\r
+ @param ImageId The image's id, which is unique within PackageList.\r
+ @param Image Points to the image.\r
+\r
+ @retval EFI_SUCCESS The new image was returned successfully.\r
+ @retval EFI_NOT_FOUND The image specified by ImageId is not available. The specified\r
+ PackageList is not in the Database.\r
+ @retval EFI_INVALID_PARAMETER Image was NULL or ImageId was 0.\r
+ @retval EFI_OUT_OF_RESOURCES The bitmap could not be retrieved because there\r
+ was not enough memory.\r
+\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+HiiGetImageEx (\r
+ IN CONST EFI_HII_IMAGE_EX_PROTOCOL *This,\r
+ IN EFI_HII_HANDLE PackageList,\r
+ IN EFI_IMAGE_ID ImageId,\r
+ OUT EFI_IMAGE_INPUT *Image\r
+ );\r
+\r
+/**\r
+ Change the information about the image.\r
+\r
+ Same with EFI_HII_IMAGE_PROTOCOL.SetImage(), this protocol invokes\r
+ EFI_HII_IMAGE_PROTOCOL.SetImage()implicitly.\r
+\r
+ @param This A pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance.\r
+ @param PackageList The package list containing the images.\r
+ @param ImageId The image's id, which is unique within PackageList.\r
+ @param Image Points to the image.\r
\r
+ @retval EFI_SUCCESS The new image was successfully updated.\r
+ @retval EFI_NOT_FOUND The image specified by ImageId is not in the\r
+ database. The specified PackageList is not in\r
+ the database.\r
+ @retval EFI_INVALID_PARAMETER The Image was NULL, the ImageId was 0 or\r
+ the Image->Bitmap was NULL.\r
+\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+HiiSetImageEx (\r
+ IN CONST EFI_HII_IMAGE_EX_PROTOCOL *This,\r
+ IN EFI_HII_HANDLE PackageList,\r
+ IN EFI_IMAGE_ID ImageId,\r
+ IN CONST EFI_IMAGE_INPUT *Image\r
+ );\r
+\r
+/**\r
+ Renders an image to a bitmap or to the display.\r
+\r
+ The prototype of this extension function is the same with\r
+ EFI_HII_IMAGE_PROTOCOL.DrawImage(). This protocol invokes\r
+ EFI_HII_IMAGE_PROTOCOL.DrawImage() implicitly.\r
+\r
+ @param This A pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance.\r
+ @param Flags Describes how the image is to be drawn.\r
+ @param Image Points to the image to be displayed.\r
+ @param Blt If this points to a non-NULL on entry, this points\r
+ to the image, which is Width pixels wide and\r
+ Height pixels high. The image will be drawn onto\r
+ this image and EFI_HII_DRAW_FLAG_CLIP is implied.\r
+ If this points to a NULL on entry, then a buffer\r
+ will be allocated to hold the generated image and\r
+ the pointer updated on exit. It is the caller's\r
+ responsibility to free this buffer.\r
+ @param BltX Specifies the offset from the left and top edge of\r
+ the output image of the first pixel in the image.\r
+ @param BltY Specifies the offset from the left and top edge of\r
+ the output image of the first pixel in the image.\r
+\r
+ @retval EFI_SUCCESS The image was successfully drawn.\r
+ @retval EFI_OUT_OF_RESOURCES Unable to allocate an output buffer for Blt.\r
+ @retval EFI_INVALID_PARAMETER The Image or Blt was NULL.\r
+\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+HiiDrawImageEx (\r
+ IN CONST EFI_HII_IMAGE_EX_PROTOCOL *This,\r
+ IN EFI_HII_DRAW_FLAGS Flags,\r
+ IN CONST EFI_IMAGE_INPUT *Image,\r
+ IN OUT EFI_IMAGE_OUTPUT **Blt,\r
+ IN UINTN BltX,\r
+ IN UINTN BltY\r
+ );\r
+\r
+/**\r
+ Renders an image to a bitmap or the screen containing the contents of the specified\r
+ image.\r
+\r
+ This function is similar to EFI_HII_IMAGE_PROTOCOL.DrawImageId(). The difference is that\r
+ this function will locate all EFI_HII_IMAGE_DECODER_PROTOCOL instances installed in the\r
+ system if the decoder of the certain image type is not supported by the\r
+ EFI_HII_IMAGE_EX_PROTOCOL. The function will attempt to decode the image to the\r
+ EFI_IMAGE_INPUT using the first EFI_HII_IMAGE_DECODER_PROTOCOL instance that\r
+ supports the requested image type.\r
+\r
+ @param This A pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance.\r
+ @param Flags Describes how the image is to be drawn.\r
+ @param PackageList The package list in the HII database to search for\r
+ the specified image.\r
+ @param ImageId The image's id, which is unique within PackageList.\r
+ @param Blt If this points to a non-NULL on entry, this points\r
+ to the image, which is Width pixels wide and\r
+ Height pixels high. The image will be drawn onto\r
+ this image and EFI_HII_DRAW_FLAG_CLIP is implied.\r
+ If this points to a NULL on entry, then a buffer\r
+ will be allocated to hold the generated image\r
+ and the pointer updated on exit. It is the caller's\r
+ responsibility to free this buffer.\r
+ @param BltX Specifies the offset from the left and top edge of\r
+ the output image of the first pixel in the image.\r
+ @param BltY Specifies the offset from the left and top edge of\r
+ the output image of the first pixel in the image.\r
+\r
+ @retval EFI_SUCCESS The image was successfully drawn.\r
+ @retval EFI_OUT_OF_RESOURCES Unable to allocate an output buffer for Blt.\r
+ @retval EFI_INVALID_PARAMETER The Blt was NULL or ImageId was 0.\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
+\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+HiiDrawImageIdEx (\r
+ IN CONST EFI_HII_IMAGE_EX_PROTOCOL *This,\r
+ IN EFI_HII_DRAW_FLAGS Flags,\r
+ IN EFI_HII_HANDLE PackageList,\r
+ IN EFI_IMAGE_ID ImageId,\r
+ IN OUT EFI_IMAGE_OUTPUT **Blt,\r
+ IN UINTN BltX,\r
+ IN UINTN BltY\r
+ );\r
+\r
+/**\r
+ This function returns the image information to EFI_IMAGE_OUTPUT. Only the width\r
+ and height are returned to the EFI_IMAGE_OUTPUT instead of decoding the image\r
+ to the buffer. This function is used to get the geometry of the image. This function\r
+ will try to locate all of the EFI_HII_IMAGE_DECODER_PROTOCOL installed on the\r
+ system if the decoder of image type is not supported by the EFI_HII_IMAGE_EX_PROTOCOL.\r
+\r
+ @param This A pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance.\r
+ @param PackageList Handle of the package list where this image will\r
+ be searched.\r
+ @param ImageId The image's id, which is unique within PackageList.\r
+ @param Image Points to the image.\r
+\r
+ @retval EFI_SUCCESS The new image was returned successfully.\r
+ @retval EFI_NOT_FOUND The image specified by ImageId is not in the\r
+ database. The specified PackageList is not in the database.\r
+ @retval EFI_BUFFER_TOO_SMALL The buffer specified by ImageSize is too small to\r
+ hold the image.\r
+ @retval EFI_INVALID_PARAMETER The Image was NULL or the ImageId was 0.\r
+ @retval EFI_OUT_OF_RESOURCES The bitmap could not be retrieved because there\r
+ was not enough memory.\r
+\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+HiiGetImageInfo (\r
+ IN CONST EFI_HII_IMAGE_EX_PROTOCOL *This,\r
+ IN EFI_HII_HANDLE PackageList,\r
+ IN EFI_IMAGE_ID ImageId,\r
+ OUT EFI_IMAGE_OUTPUT *Image\r
+ );\r
//\r
// EFI_HII_STRING_PROTOCOL\r
//\r
buffer that is required for the handles found.\r
@param Handle An array of EFI_HII_HANDLE instances returned.\r
\r
- @retval EFI_SUCCESS The matching handles are outputed successfully.\r
+ @retval EFI_SUCCESS The matching handles are outputted successfully.\r
HandleBufferLength is updated with the actual length.\r
@retval EFI_BUFFER_TO_SMALL The HandleBufferLength parameter indicates that\r
Handle is too small to support the number of\r
Handle is too small to support the number of\r
handles. HandleBufferLength is updated with\r
a value that will enable the data to fit.\r
- @retval EFI_NOT_FOUND The specifiecd Handle could not be found in the\r
+ @retval EFI_NOT_FOUND The specified Handle could not be found in the\r
current database.\r
@retval EFI_INVALID_PARAMETER BufferSize was NULL.\r
- @retval EFI_INVALID_PARAMETER The value referenced by BufferSize was not zero \r
+ @retval EFI_INVALID_PARAMETER The value referenced by BufferSize was not zero\r
and Buffer was NULL.\r
\r
**/\r
unregistered.\r
\r
@retval EFI_SUCCESS Notification is unregistered successfully.\r
- @retval EFI_NOT_FOUND The incoming notification handle does not exist \r
+ @retval EFI_NOT_FOUND The incoming notification handle does not exist\r
in current hii database.\r
\r
**/\r
instance.\r
@param Results Null-terminated Unicode string in\r
<MultiConfigAltResp> format which has all values\r
- filled in for the entirety of the current HII \r
- database. String to be allocated by the called \r
+ filled in for the entirety of the current HII\r
+ database. String to be allocated by the called\r
function. De-allocation is up to the caller.\r
\r
@retval EFI_SUCCESS The Results string is filled with the values\r
value pair. Block is left updated and\r
Progress points at the '&' preceding the first\r
non-<BlockName>.\r
- @retval EFI_BUFFER_TOO_SMALL Block not large enough. Progress undefined. \r
+ @retval EFI_BUFFER_TOO_SMALL Block not large enough. Progress undefined.\r
BlockSize is updated with the required buffer size.\r
\r
**/\r
This function accepts a <MultiKeywordResp> formatted string, finds the associated\r
keyword owners, creates a <MultiConfigResp> string from it and forwards it to the\r
EFI_HII_ROUTING_PROTOCOL.RouteConfig function.\r
- \r
- If there is an issue in resolving the contents of the KeywordString, then the \r
- function returns an error and also sets the Progress and ProgressErr with the \r
+\r
+ If there is an issue in resolving the contents of the KeywordString, then the\r
+ function returns an error and also sets the Progress and ProgressErr with the\r
appropriate information about where the issue occurred and additional data about\r
- the nature of the issue. \r
- \r
+ the nature of the issue.\r
+\r
In the case when KeywordString containing multiple keywords, when an EFI_NOT_FOUND\r
error is generated during processing the second or later keyword element, the system\r
- storage associated with earlier keywords is not modified. All elements of the \r
+ storage associated with earlier keywords is not modified. All elements of the\r
KeywordString must successfully pass all tests for format and access prior to making\r
any modifications to storage.\r
- \r
+\r
In the case when EFI_DEVICE_ERROR is returned from the processing of a KeywordString\r
containing multiple keywords, the state of storage associated with earlier keywords\r
is undefined.\r
\r
@param This Pointer to the EFI_KEYWORD_HANDLER _PROTOCOL instance.\r
\r
- @param KeywordString A null-terminated string in <MultiKeywordResp> format. \r
+ @param KeywordString A null-terminated string in <MultiKeywordResp> format.\r
\r
- @param Progress On return, points to a character in the KeywordString. \r
- Points to the string's NULL terminator if the request \r
- was successful. Points to the most recent '&' before \r
+ @param Progress On return, points to a character in the KeywordString.\r
+ Points to the string's NULL terminator if the request\r
+ was successful. Points to the most recent '&' before\r
the first failing name / value pair (or the beginning\r
of the string if the failure is in the first name / value\r
pair) if the request was not successful.\r
\r
@param ProgressErr If during the processing of the KeywordString there was\r
- a failure, this parameter gives additional information \r
- about the possible source of the problem. The various \r
+ a failure, this parameter gives additional information\r
+ about the possible source of the problem. The various\r
errors are defined in "Related Definitions" below.\r
\r
\r
\r
@retval EFI_INVALID_PARAMETER One or more of the following are TRUE:\r
1. KeywordString is NULL.\r
- 2. Parsing of the KeywordString resulted in an \r
+ 2. Parsing of the KeywordString resulted in an\r
error. See Progress and ProgressErr for more data.\r
\r
- @retval EFI_NOT_FOUND An element of the KeywordString was not found. \r
+ @retval EFI_NOT_FOUND An element of the KeywordString was not found.\r
See ProgressErr for more data.\r
\r
- @retval EFI_OUT_OF_RESOURCES Required system resources could not be allocated. \r
+ @retval EFI_OUT_OF_RESOURCES Required system resources could not be allocated.\r
See ProgressErr for more data.\r
- \r
- @retval EFI_ACCESS_DENIED The action violated system policy. See ProgressErr \r
+\r
+ @retval EFI_ACCESS_DENIED The action violated system policy. See ProgressErr\r
for more data.\r
\r
@retval EFI_DEVICE_ERROR An unexpected system error occurred. See ProgressErr\r
\r
**/\r
EFI_STATUS\r
-EFIAPI \r
+EFIAPI\r
EfiConfigKeywordHandlerSetData (\r
IN EFI_CONFIG_KEYWORD_HANDLER_PROTOCOL *This,\r
IN CONST EFI_STRING KeywordString,\r
\r
/**\r
\r
- This function accepts a <MultiKeywordRequest> formatted string, finds the underlying \r
+ This function accepts a <MultiKeywordRequest> formatted string, finds the underlying\r
keyword owners, creates a <MultiConfigRequest> string from it and forwards it to the\r
EFI_HII_ROUTING_PROTOCOL.ExtractConfig function.\r
- \r
+\r
If there is an issue in resolving the contents of the KeywordString, then the function\r
returns an EFI_INVALID_PARAMETER and also set the Progress and ProgressErr with the\r
appropriate information about where the issue occurred and additional data about the\r
nature of the issue.\r
- \r
+\r
In the case when KeywordString is NULL, or contains multiple keywords, or when\r
EFI_NOT_FOUND is generated while processing the keyword elements, the Results string\r
- contains values returned for all keywords processed prior to the keyword generating the \r
+ contains values returned for all keywords processed prior to the keyword generating the\r
error but no values for the keyword with error or any following keywords.\r
\r
- \r
+\r
@param This Pointer to the EFI_KEYWORD_HANDLER _PROTOCOL instance.\r
- \r
+\r
@param NameSpaceId A null-terminated string containing the platform configuration\r
language to search through in the system. If a NULL is passed\r
in, then it is assumed that any platform configuration language\r
with the prefix of "x-UEFI-" are searched.\r
- \r
+\r
@param KeywordString A null-terminated string in <MultiKeywordRequest> format. If a\r
- NULL is passed in the KeywordString field, all of the known \r
- keywords in the system for the NameSpaceId specified are \r
+ NULL is passed in the KeywordString field, all of the known\r
+ keywords in the system for the NameSpaceId specified are\r
returned in the Results field.\r
- \r
+\r
@param Progress On return, points to a character in the KeywordString. Points\r
- to the string's NULL terminator if the request was successful. \r
+ to the string's NULL terminator if the request was successful.\r
Points to the most recent '&' before the first failing name / value\r
pair (or the beginning of the string if the failure is in the first\r
name / value pair) if the request was not successful.\r
- \r
+\r
@param ProgressErr If during the processing of the KeywordString there was a\r
- failure, this parameter gives additional information about the \r
+ failure, this parameter gives additional information about the\r
possible source of the problem. See the definitions in SetData()\r
for valid value definitions.\r
- \r
+\r
@param Results A null-terminated string in <MultiKeywordResp> format is returned\r
- which has all the values filled in for the keywords in the \r
+ which has all the values filled in for the keywords in the\r
KeywordString. This is a callee-allocated field, and must be freed\r
- by the caller after being used. \r
+ by the caller after being used.\r
\r
@retval EFI_SUCCESS The specified action was completed successfully.\r
- \r
+\r
@retval EFI_INVALID_PARAMETER One or more of the following are TRUE:\r
- 1.Progress, ProgressErr, or Resuts is NULL.\r
+ 1.Progress, ProgressErr, or Results is NULL.\r
2.Parsing of the KeywordString resulted in an error. See\r
Progress and ProgressErr for more data.\r
- \r
+\r
\r
@retval EFI_NOT_FOUND An element of the KeywordString was not found. See\r
ProgressErr for more data.\r
\r
@retval EFI_OUT_OF_RESOURCES Required system resources could not be allocated. See\r
ProgressErr for more data.\r
- \r
+\r
@retval EFI_ACCESS_DENIED The action violated system policy. See ProgressErr for\r
more data.\r
\r
\r
**/\r
EFI_STATUS\r
-EFIAPI \r
+EFIAPI\r
EfiConfigKeywordHandlerGetData (\r
IN EFI_CONFIG_KEYWORD_HANDLER_PROTOCOL *This,\r
IN CONST EFI_STRING NameSpaceId, OPTIONAL\r
IN CONST EFI_STRING KeywordString, OPTIONAL\r
- OUT EFI_STRING *Progress, \r
+ OUT EFI_STRING *Progress,\r
OUT UINT32 *ProgressErr,\r
OUT EFI_STRING *Results\r
);\r
;\r
\r
/**\r
- Retrieves a pointer to the a Null-terminated ASCII string containing the list \r
- of languages that an HII handle in the HII Database supports. The returned \r
+ Retrieves a pointer to a Null-terminated ASCII string containing the list\r
+ of languages that an HII handle in the HII Database supports. The returned\r
string is allocated using AllocatePool(). The caller is responsible for freeing\r
the returned string using FreePool(). The format of the returned string follows\r
the language format assumed the HII Database.\r
- \r
+\r
If HiiHandle is NULL, then ASSERT().\r
\r
@param[in] HiiHandle A handle that was previously registered in the HII Database.\r
\r
@retval NULL HiiHandle is not registered in the HII database\r
- @retval NULL There are not enough resources available to retrieve the suported \r
+ @retval NULL There are not enough resources available to retrieve the supported\r
languages.\r
- @retval NULL The list of suported languages could not be retrieved.\r
+ @retval NULL The list of supported languages could not be retrieved.\r
@retval Other A pointer to the Null-terminated ASCII string of supported languages.\r
\r
**/\r
projects / mirror_edk2.git / blobdiff