information from configuration applications, routing the\r
results to the appropriate drivers.\r
\r
- Copyright (c) 2006 - 2009, Intel Corporation\r
+ Copyright (c) 2006 - 2010, 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
They must have an additional description indicating the type of\r
alternative configuration the string represents,\r
"ALTCFG=<StringToken>". That <StringToken> (when converted from\r
- Hex UNICODE to binary) is a reference to a string in the\r
+ hexadecimal (encoded as text) to binary) is a reference to a string in the\r
associated string pack. As an example, assume that the Request\r
string is:\r
GUID=...&NAME=00480050&PATH=...&Fred&George&Ron&Neville A result\r
@param This Points to the EFI_HII_CONFIG_ROUTING_PROTOCOL\r
instance.\r
\r
- @param Request A null-terminated Unicode string in\r
- <MultiConfigRequest> format.\r
+ @param Request A null-terminated string in <MultiConfigRequest> format.\r
\r
@param Progress On return, points to a character in the\r
Request string. Points to the string's null\r
name / value pair) if the request was not\r
successful\r
\r
- @param Results Null-terminated Unicode string in\r
- <MultiConfigAltResp> format which has all\r
- values filled in for the names in the\r
- Request string. String to be allocated by\r
- the called function.\r
+ @param Results A null-terminated string in <MultiConfigAltResp> format\r
+ which has all values filled in for the names in the\r
+ Request string.\r
\r
@retval EFI_SUCCESS The Results string is filled with the\r
values corresponding to all requested\r
);\r
\r
/**\r
- \r
+ This function allows the caller to request the current configuration \r
+ for the entirety of the current HII database and returns the data in\r
+ a null-terminated string.\r
+\r
This function allows the caller to request the current\r
configuration for all of the current HII database. The results\r
include both the current and alternate configurations as\r
- described in ExtractConfig() above. Implementation note: This\r
- call has deceptively few inputs but the implementation is likely\r
- to be somewhat complex. The requirement is to scan all IFR in\r
- the HII database to determine the list of names and then request\r
- the configuration using the corresponding drivers.\r
- EFI_HII_CONFIG_ACCESS_PROTOCOL.ExtractConfig() interfaces below.\r
+ described in ExtractConfig() above. \r
\r
@param This Points to the EFI_HII_CONFIG_ROUTING_PROTOCOL instance.\r
\r
- @param Results A null-terminated Unicode string in\r
- <MultiConfigAltResp> format which has all\r
- values filled in for the names in the Request\r
- string. String to be allocated by this\r
- function. De-allocation is up to the caller.\r
+ @param Results A null-terminated string in <MultiConfigAltResp>\r
+ format which has all values filled in for the\r
+ names in the Request string.\r
+ String to be allocated by this function.\r
+ De-allocation is up to the caller.\r
\r
@retval EFI_SUCCESS The Results string is filled with the\r
values corresponding to all requested\r
\r
@param This Points to the EFI_HII_CONFIG_ROUTING_PROTOCOL instance.\r
\r
- @param Configuration A null-terminated Unicode string in\r
- <MulltiConfigResp> format.\r
+ @param Configuration A null-terminated string in <MulltiConfigResp> format.\r
\r
@param Progress A pointer to a string filled in with the\r
offset of the most recent '&' before the\r
consists of a list of <BlockName> formatted names. It uses the\r
offset in the name to determine the index into the Block to\r
start the extraction and the width of each name to determine the\r
- number of bytes to extract. These are mapped to a UNICODE value\r
+ number of bytes to extract. These are mapped to a string\r
using the equivalent of the C "%x" format (with optional leading\r
spaces). The call fails if, for any (offset, width) pair in\r
ConfigRequest, offset+value >= BlockSize.\r
\r
@param This Points to the EFI_HII_CONFIG_ROUTING_PROTOCOL instance.\r
\r
- @param ConfigRequest A null-terminated Unicode string in\r
- <ConfigRequest> format.\r
+ @param ConfigRequest A null-terminated string in <ConfigRequest> format.\r
\r
@param Block Array of bytes defining the block's\r
configuration.\r
\r
@param Config Filled-in configuration string. String\r
allocated by the function. Returned only if\r
- call is successful.\r
+ call is successful. The null-terminated string \r
+ will be <ConfigResp> format.\r
\r
@param Progress A pointer to a string filled in with the\r
offset of the most recent '&' before the\r
\r
@param This Points to the EFI_HII_CONFIG_ROUTING_PROTOCOL instance.\r
\r
- @param ConfigResp A null-terminated Unicode string in\r
- <ConfigResp> format.\r
+ @param ConfigResp A null-terminated string in <ConfigResp> format.\r
\r
@param Block A possibly null array of bytes\r
representing the current block. Only\r
This helper function is to be called by drivers to extract portions of \r
a larger configuration string.\r
\r
- @param This A pointer to the EFI_HII_CONFIG_ROUTING_PROTOCOL instance. \r
- @param Configuration A null-terminated Unicode string in <MultiConfigAltResp> format.\r
+ @param This A pointer to the EFI_HII_CONFIG_ROUTING_PROTOCOL instance.\r
+ @param ConfigResp A null-terminated string in <ConfigAltResp> format.\r
@param Guid A pointer to the GUID value to search for in the \r
routing portion of the ConfigResp string when retrieving \r
the requested data. If Guid is NULL, then all GUID \r
@param AltCfgResp A pointer to a buffer which will be allocated by the \r
function which contains the retrieved string as requested. \r
This buffer is only allocated if the call was successful. \r
+ The null-terminated string will be <ConfigResp> format.\r
\r
@retval EFI_SUCCESS The request succeeded. The requested data was extracted \r
and placed in the newly allocated AltCfgResp buffer.\r
EFI_STATUS \r
(EFIAPI * EFI_HII_GET_ALT_CFG)(\r
IN CONST EFI_HII_CONFIG_ROUTING_PROTOCOL *This, \r
- IN CONST EFI_STRING Configuration, \r
+ IN CONST EFI_STRING ConfigResp, \r
IN CONST EFI_GUID *Guid, \r
IN CONST EFI_STRING Name, \r
IN CONST EFI_DEVICE_PATH_PROTOCOL *DevicePath, \r
projects / mirror_edk2.git / blobdiff