4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncImplementation of interfaces function for EFI_HII_CONFIG_ROUTING_PROTOCOL.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncCopyright (c) 2007 - 2011, Intel Corporation. All rights reserved.<BR>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncThis program and the accompanying materials
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncare licensed and made available under the terms and conditions of the BSD License
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncwhich accompanies this distribution. The full text of the license may be found at
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncTHE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncWITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Calculate the number of Unicode characters of the incoming Configuration string,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync not including NULL terminator.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This is a internal function.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param String String in <MultiConfigRequest> or
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync <MultiConfigResp> format.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @return The number of Unicode characters.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // "GUID=" should be the first element of incoming string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ASSERT (StrnCmp (String, L"GUID=", StrLen (L"GUID=")) == 0);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // The beginning of next <ConfigRequest>/<ConfigResp> should be "&GUID=".
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Will meet '\0' if there is only one <ConfigRequest>/<ConfigResp>.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Convert the hex UNICODE %02x encoding of a UEFI device path to binary
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync from <PathHdr> of <ConfigHdr>.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This is a internal function.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param String UEFI configuration string
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param DevicePathData Binary of a UEFI device path.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_NOT_FOUND The device path is not invalid.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER Any incoming parameter is invalid.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_OUT_OF_RESOURCES Lake of resources to store neccesary structures.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS The device path is retrieved and translated to
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync binary format.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Find the 'PATH=' of <PathHdr> and skip it.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (; (*String != 0 && StrnCmp (String, L"PATH=", StrLen (L"PATH=")) != 0); String++);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (*String == 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check whether path data does exist.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (*String == 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // The content between 'PATH=' of <ConfigHdr> and '&' of next element
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // or '\0' (end of configuration string) is the UNICODE %02x bytes encoding
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // of UEFI device path.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (Length = 0; *String != 0 && *String != L'&'; String++, Length++);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check DevicePath Length
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (((Length + 1) / 2) < sizeof (EFI_DEVICE_PATH_PROTOCOL)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // The data in <PathHdr> is encoded as hex UNICODE %02x bytes in the same order
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // as the device path resides in RAM memory.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Translate the data into binary.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DevicePathBuffer = (UINT8 *) AllocateZeroPool ((Length + 1) / 2);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Convert DevicePath
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DevicePathBuffer [Index/2] = (UINT8) ((DevicePathBuffer [Index/2] << 4) + DigitUint8);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Validate DevicePath
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DevicePath = (EFI_DEVICE_PATH_PROTOCOL *) DevicePathBuffer;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((DevicePath->Type == 0) || (DevicePath->SubType == 0) || (DevicePathNodeLength (DevicePath) < sizeof (EFI_DEVICE_PATH_PROTOCOL))) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Invalid device path
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // return the device path
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Converts the unicode character of the string from uppercase to lowercase.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This is a internal function.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param ConfigString String to be converted
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Convert all hex digits in range [A-F] in the configuration header to [a-f]
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (String = ConfigString, Lower = FALSE; *String != L'\0'; String++) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync } else if (Lower && *String >= L'A' && *String <= L'F') {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Generate a sub string then output it.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This is a internal function.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param String A constant string which is the prefix of the to be
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync generated string, e.g. GUID=
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param BufferLen The length of the Buffer in bytes.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Buffer Points to a buffer which will be converted to be the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync content of the generated string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Flag If 1, the buffer contains data for the value of GUID or PATH stored in
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync UINT8 *; if 2, the buffer contains unicode string for the value of NAME;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if 3, the buffer contains other data.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param SubStr Points to the output string. It's caller's
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync responsibility to free this buffer.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *SubStr = AllocateCopyPool (StrSize (String), String);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Header + Data + '&' + '\0'
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Convert Buffer to Hex String in reverse order
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (Index = 0; Index < BufferLen; Index ++, TemBuffer ++) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync TemString += UnicodeValueToString (TemString, PREFIX_ZERO | RADIX_HEX, *TemBuffer, 2);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check buffer is enough
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ASSERT ((BufferLen * 2 + 1) >= (StrLen (TemName) * 4 + 1));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Convert Unicode String to Config String, e.g. "ABCD" => "0041004200430044"
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync TemString += UnicodeValueToString (TemString, PREFIX_ZERO | RADIX_HEX, *TemName, 4);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Convert Buffer to Hex String
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (Index = 0; Index < BufferLen; Index ++, TemBuffer --) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync TemString += UnicodeValueToString (TemString, PREFIX_ZERO | RADIX_HEX, *TemBuffer, 2);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Convert the uppercase to lowercase since <HexAf> is defined in lowercase format.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Retrieve the <ConfigBody> from String then output it.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This is a internal function.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param String A sub string of a configuration string in
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync <MultiConfigAltResp> format.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param ConfigBody Points to the output string. It's caller's
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync responsibility to free this buffer.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER There is no form package in current hii database.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_OUT_OF_RESOURCES Not enough memory to finish this operation.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS All existing storage is exported.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // The setting information should start OFFSET, not ALTCFG.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (StrnCmp (String, L"&ALTCFG=", StrLen (L"&ALTCFG=")) == 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // It is the last <ConfigResp> of the incoming configuration string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Result = AllocateCopyPool (StrSize (String), String);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Result = AllocateCopyPool (Length * sizeof (CHAR16), String);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Append a string to a multi-string format.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This is a internal function.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param MultiString String in <MultiConfigRequest>,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync <MultiConfigAltResp>, or <MultiConfigResp>. On
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync input, the buffer length of this string is
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync MAX_STRING_LENGTH. On output, the buffer length
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync might be updated.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param AppendString NULL-terminated Unicode string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER Any incoming parameter is invalid.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS AppendString is append to the end of MultiString
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (MultiString == NULL || *MultiString == NULL || AppendString == NULL) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Enlarge the buffer each time when length exceeds MAX_STRING_LENGTH.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (MultiStringSize + AppendStringSize > MAX_STRING_LENGTH ||
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Append the incoming string
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Get the value of <Number> in <BlockConfig> format, i.e. the value of OFFSET
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync or WIDTH or VALUE.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync <BlockConfig> ::= 'OFFSET='<Number>&'WIDTH='<Number>&'VALUE'=<Number>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This is a internal function.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param StringPtr String in <BlockConfig> format and points to the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync first character of <Number>.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Number The output value. Caller takes the responsibility
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync to free memory.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Len Length of the <Number>, in characters.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_OUT_OF_RESOURCES Insufficient resources to store neccessary
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync structures.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS Value of <Number> is outputted in Number
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync successfully.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (StringPtr == NULL || *StringPtr == L'\0' || Number == NULL || Len == NULL) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync while (*StringPtr != L'\0' && *StringPtr != L'&') {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Str = (EFI_STRING) AllocateZeroPool (Length * sizeof (CHAR16));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Buf [Index/2] = (UINT8) ((DigitUint8 << 4) + Buf [Index/2]);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This function merges DefaultAltCfgResp string into AltCfgResp string for
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync the missing AltCfgId in AltCfgResq.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param AltCfgResp Pointer to a null-terminated Unicode string in
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync <ConfigAltResp> format. The default value string
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync will be merged into it.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param DefaultAltCfgResp Pointer to a null-terminated Unicode string in
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync <MultiConfigAltResp> format. The default value
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync string may contain more than one ConfigAltResp
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync string for the different varstore buffer.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS The merged string returns.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER *AltCfgResp is to NULL.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get the requestr ConfigHdr
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Find <ConfigHdr> GUID=...&NAME=...&PATH=...
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (StrnCmp (StringPtr, L"GUID=", StrLen (L"GUID=")) != 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync while (*StringPtr != L'\0' && StrnCmp (StringPtr, L"&NAME=", StrLen (L"&NAME=")) != 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync while (*StringPtr != L'\0' && StrnCmp (StringPtr, L"&PATH=", StrLen (L"&PATH=")) != 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync while (*StringPtr != L'\0' && *StringPtr != L'&') {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Construct AltConfigHdr string "&<ConfigHdr>&ALTCFG=XXXX\0"
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // |1| StrLen (ConfigHdr) | 8 | 4 | 1 |
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync AltConfigHdr = AllocateZeroPool ((1 + HeaderLength + 8 + 4 + 1) * sizeof (CHAR16));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync StringPtrDefault = StrStr (DefaultAltCfgResp, AltConfigHdr);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get AltCfg Name
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync StrnCat (AltConfigHdr, StringPtrDefault + HeaderLength, 4);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Append the found default value string to the input AltCfgResp
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync StringPtrEnd = StrStr (StringPtrDefault + 1, L"&GUID");
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // No more default string is found.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Find next AltCfg String
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync StringPtrDefault = StrStr (StringPtrDefault + 1, AltConfigHdr);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This function inserts new DefaultValueData into the BlockData DefaultValue array.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param BlockData The BlockData is updated to add new default value.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param DefaultValueData The DefaultValue is added.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (Link = BlockData->DefaultValueEntry.ForwardLink; Link != &BlockData->DefaultValueEntry; Link = Link->ForwardLink) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DefaultValueArray = BASE_CR (Link, IFR_DEFAULT_DATA, Entry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (DefaultValueArray->DefaultId == DefaultValueData->DefaultId) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // DEFAULT_VALUE_FROM_OPCODE has high priority, DEFAULT_VALUE_FROM_DEFAULT has low priority.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (DefaultValueData->Type > DefaultValueArray->Type) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Update the default value array in BlockData.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync CopyMem (&DefaultValueArray->Value, &DefaultValueData->Value, sizeof (EFI_IFR_TYPE_VALUE));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DefaultValueArray->Cleaned = DefaultValueData->Cleaned;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Insert new default value data in tail.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DefaultValueArray = AllocateZeroPool (sizeof (IFR_DEFAULT_DATA));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync CopyMem (DefaultValueArray, DefaultValueData, sizeof (IFR_DEFAULT_DATA));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This function inserts new BlockData into the block link
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param BlockLink The list entry points to block array.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param BlockData The point to BlockData is added.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Insert block data in its Offset and Width order.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (Link = BlockLink->ForwardLink; Link != BlockLink; Link = Link->ForwardLink) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BlockArray = BASE_CR (Link, IFR_BLOCK_DATA, Entry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (BlockArray->Offset == BlockSingleData->Offset) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Insert this block data in the front of block array
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // The same block array has been added.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync } else if (BlockArray->Offset > BlockSingleData->Offset) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Insert new block data in the front of block array
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Add new block data into the tail.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This function checks VarOffset and VarWidth is in the block range.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param RequestBlockArray The block array is to be checked.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param VarOffset Offset of var to the structure
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param VarWidth Width of var.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval TRUE This Var is in the block range.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval FALSE This Var is not in the block range.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // No Request Block array, all vars are got.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check the input var is in the request block range.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (Link = RequestBlockArray->Entry.ForwardLink; Link != &RequestBlockArray->Entry; Link = Link->ForwardLink) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((VarOffset >= BlockData->Offset) && ((VarOffset + VarWidth) <= (BlockData->Offset + BlockData->Width))) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Get form package data from data base.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param DataBaseRecord The DataBaseRecord instance contains the found Hii handle and package.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param HiiFormPackage The buffer saves the package data.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param PackageSize The buffer size of the package data.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (DataBaseRecord == NULL || HiiFormPackage == NULL || PackageSize == NULL) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // 0. Get Hii Form Package by HiiHandle
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get HiiFormPackage by HiiHandle
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This function parses Form Package to get the efi varstore info according to the request ConfigHdr.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param DataBaseRecord The DataBaseRecord instance contains the found Hii handle and package.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param ConfigHdr Request string ConfigHdr. If it is NULL,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync the first found varstore will be as ConfigHdr.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param IsEfiVarstore Whether the request storage type is efi varstore type.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param EfiVarStore The efi varstore info which will return.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = GetFormPackageData(DataBaseRecord, &HiiFormPackage, &PackageSize);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IfrOpHdr = (EFI_IFR_OP_HEADER *) (HiiFormPackage + IfrOffset);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (IfrOpHdr->OpCode == EFI_IFR_VARSTORE_EFI_OP ) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IfrEfiVarStore = (EFI_IFR_VARSTORE_EFI *) IfrOpHdr;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // If the length is small than the structure, this is from old efi
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // varstore definition. Old efi varstore get config directly from
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // GetVariable function.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (IfrOpHdr->Length < sizeof (EFI_IFR_VARSTORE_EFI)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync VarStoreName = AllocateZeroPool (AsciiStrSize ((CHAR8 *)IfrEfiVarStore->Name) * sizeof (CHAR16));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync AsciiStrToUnicodeStr ((CHAR8 *) IfrEfiVarStore->Name, VarStoreName);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync GenerateSubStr (L"GUID=", sizeof (EFI_GUID), (VOID *) &IfrEfiVarStore->Guid, 1, &GuidStr);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync GenerateSubStr (L"NAME=", StrLen (VarStoreName) * sizeof (CHAR16), (VOID *) VarStoreName, 2, &NameStr);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync LengthString = LengthString + StrLen (NameStr) + 1;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync TempStr = AllocateZeroPool (LengthString * sizeof (CHAR16));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (ConfigHdr == NULL || StrnCmp (ConfigHdr, TempStr, StrLen (TempStr)) == 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *EfiVarStore = (EFI_IFR_VARSTORE_EFI *) AllocateZeroPool (IfrOpHdr->Length);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync CopyMem (*EfiVarStore, IfrEfiVarStore, IfrOpHdr->Length);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Free alllocated temp string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This function parses Form Package to get the block array and the default
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync value array according to the request ConfigHdr.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Package Pointer to the form package data.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param PackageLength Length of the pacakge.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param ConfigHdr Request string ConfigHdr. If it is NULL,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync the first found varstore will be as ConfigHdr.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param RequestBlockArray The block array is retrieved from the request string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param VarStorageData VarStorage structure contains the got block and default value.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param PIfrDefaultIdArray Point to the got default id and default name array.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS The block array and the default value array are got.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER The varstore defintion in the differnt form pacakges
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync are conflicted.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_OUT_OF_RESOURCES No enough memory.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Go through the form package to parse OpCode one by one.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IfrOpHdr = (EFI_IFR_OP_HEADER *) (Package + IfrOffset);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // VarStore is found. Don't need to search any more.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get the requied varstore information
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Add varstore by Guid and Name in ConfigHdr
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Make sure Offset is in varstore size and varstoreid
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync VarStoreName = AllocateZeroPool (AsciiStrSize ((CHAR8 *)IfrVarStore->Name) * sizeof (CHAR16));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync AsciiStrToUnicodeStr ((CHAR8 *) IfrVarStore->Name, VarStoreName);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync GenerateSubStr (L"GUID=", sizeof (EFI_GUID), (VOID *) &IfrVarStore->Guid, 1, &GuidStr);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync GenerateSubStr (L"NAME=", StrLen (VarStoreName) * sizeof (CHAR16), (VOID *) VarStoreName, 2, &NameStr);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync LengthString = LengthString + StrLen (NameStr) + 1;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync TempStr = AllocateZeroPool (LengthString * sizeof (CHAR16));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (ConfigHdr == NULL || StrnCmp (ConfigHdr, TempStr, StrLen (TempStr)) == 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Find the matched VarStore
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync CopyGuid (&VarStorageData->Guid, (EFI_GUID *) (VOID *) &IfrVarStore->Guid);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync VarStorageData->VarStoreId = IfrVarStore->VarStoreId;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // No found, free the allocated memory
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Free alllocated temp string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // VarStore is found. Don't need to search any more.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get the requied varstore information
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Add varstore by Guid and Name in ConfigHdr
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Make sure Offset is in varstore size and varstoreid
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IfrEfiVarStore = (EFI_IFR_VARSTORE_EFI *) IfrOpHdr;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // If the length is small than the structure, this is from old efi
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // varstore definition. Old efi varstore get config directly from
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // GetVariable function.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (IfrOpHdr->Length < sizeof (EFI_IFR_VARSTORE_EFI)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync VarStoreName = AllocateZeroPool (AsciiStrSize ((CHAR8 *)IfrEfiVarStore->Name) * sizeof (CHAR16));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync AsciiStrToUnicodeStr ((CHAR8 *) IfrEfiVarStore->Name, VarStoreName);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync GenerateSubStr (L"GUID=", sizeof (EFI_GUID), (VOID *) &IfrEfiVarStore->Guid, 1, &GuidStr);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync GenerateSubStr (L"NAME=", StrLen (VarStoreName) * sizeof (CHAR16), (VOID *) VarStoreName, 2, &NameStr);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync LengthString = LengthString + StrLen (NameStr) + 1;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync TempStr = AllocateZeroPool (LengthString * sizeof (CHAR16));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (ConfigHdr == NULL || StrnCmp (ConfigHdr, TempStr, StrLen (TempStr)) == 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Find the matched VarStore
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync CopyGuid (&VarStorageData->Guid, (EFI_GUID *) (VOID *) &IfrEfiVarStore->Guid);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync VarStorageData->VarStoreId = IfrEfiVarStore->VarStoreId;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // No found, free the allocated memory
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Free alllocated temp string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Add new the map between default id and default name.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DefaultDataPtr = (IFR_DEFAULT_DATA *) AllocateZeroPool (sizeof (IFR_DEFAULT_DATA));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DefaultDataPtr->DefaultId = ((EFI_IFR_DEFAULTSTORE *) IfrOpHdr)->DefaultId;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync InsertTailList (&DefaultIdArray->Entry, &DefaultDataPtr->Entry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // No matched varstore is found and directly return.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Ref question is not in IFR Form. This IFR form is not valid.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check whether this question is for the requested varstore.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (IfrRef->Question.VarStoreId != VarStorageData->VarStoreId) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get Offset/Width by Question header.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync VarOffset = IfrRef->Question.VarStoreInfo.VarOffset;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check whether this question is in requested block array.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!BlockArrayCheck (RequestBlockArray, VarOffset, VarWidth)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // This question is not in the requested string. Skip it.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check this var question is in the var storage
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((VarOffset + VarWidth) > VarStorageData->Size) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Set Block Data
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BlockData = (IFR_BLOCK_DATA *) AllocateZeroPool (sizeof (IFR_BLOCK_DATA));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BlockData->QuestionId = IfrRef->Question.QuestionId;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync InitializeListHead (&BlockData->DefaultValueEntry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Add Block Data into VarStorageData BlockEntry
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync InsertBlockData (&VarStorageData->BlockEntry, &BlockData);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Numeric and OneOf has the same opcode structure.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Numeric and OneOf question is not in IFR Form. This IFR form is not valid.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check whether this question is for the requested varstore.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (IfrOneOf->Question.VarStoreId != VarStorageData->VarStoreId) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get Offset/Width by Question header and OneOf Flags
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync VarOffset = IfrOneOf->Question.VarStoreInfo.VarOffset;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync VarWidth = (UINT16) (1 << (IfrOneOf->Flags & EFI_IFR_NUMERIC_SIZE));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check whether this question is in requested block array.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!BlockArrayCheck (RequestBlockArray, VarOffset, VarWidth)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // This question is not in the requested string. Skip it.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check this var question is in the var storage
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((VarOffset + VarWidth) > VarStorageData->Size) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Set Block Data
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BlockData = (IFR_BLOCK_DATA *) AllocateZeroPool (sizeof (IFR_BLOCK_DATA));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BlockData->QuestionId = IfrOneOf->Question.QuestionId;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync InitializeListHead (&BlockData->DefaultValueEntry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Add Block Data into VarStorageData BlockEntry
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync InsertBlockData (&VarStorageData->BlockEntry, &BlockData);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Set this flag to TRUE for the first oneof option.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync } else if (IfrOpHdr->OpCode == EFI_IFR_NUMERIC_OP) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Numeric minimum value will be used as default value when no default is specified.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync CopyMem (&DefaultData.Value.u16, &IfrOneOf->data.u16.MinValue, sizeof (UINT16));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync CopyMem (&DefaultData.Value.u32, &IfrOneOf->data.u32.MinValue, sizeof (UINT32));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync CopyMem (&DefaultData.Value.u64, &IfrOneOf->data.u64.MinValue, sizeof (UINT64));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Set default value base on the DefaultId list get from IFR data.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (LinkData = DefaultIdArray->Entry.ForwardLink; LinkData != &DefaultIdArray->Entry; LinkData = LinkData->ForwardLink) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DefaultDataPtr = BASE_CR (LinkData, IFR_DEFAULT_DATA, Entry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // offset by question header
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // width by EFI_IFR_ORDERED_LIST MaxContainers * OneofOption Type
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // no default value and default id, how to define its default value?
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // OrderedList question is not in IFR Form. This IFR form is not valid.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check whether this question is for the requested varstore.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IfrOrderedList = (EFI_IFR_ORDERED_LIST *) IfrOpHdr;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (IfrOrderedList->Question.VarStoreId != VarStorageData->VarStoreId) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get Offset/Width by Question header and OneOf Flags
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync VarOffset = IfrOrderedList->Question.VarStoreInfo.VarOffset;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Set Block Data
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BlockData = (IFR_BLOCK_DATA *) AllocateZeroPool (sizeof (IFR_BLOCK_DATA));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BlockData->QuestionId = IfrOrderedList->Question.QuestionId;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync InitializeListHead (&BlockData->DefaultValueEntry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // EFI_IFR_DEFAULT_OP
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // offset by question header
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // width is 1 sizeof (BOOLEAN)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // default id by CheckBox Flags if CheckBox flags (Default or Mau) is set, the default value is 1 to be set.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // value by DefaultOption
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // default id by DeaultOption DefaultId can override CheckBox Flags and Default value.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // CheckBox question is not in IFR Form. This IFR form is not valid.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check whether this question is for the requested varstore.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (IfrCheckBox->Question.VarStoreId != VarStorageData->VarStoreId) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get Offset/Width by Question header and OneOf Flags
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync VarOffset = IfrCheckBox->Question.VarStoreInfo.VarOffset;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check whether this question is in requested block array.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!BlockArrayCheck (RequestBlockArray, VarOffset, VarWidth)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // This question is not in the requested string. Skip it.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check this var question is in the var storage
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((VarOffset + VarWidth) > VarStorageData->Size) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Set Block Data
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BlockData = (IFR_BLOCK_DATA *) AllocateZeroPool (sizeof (IFR_BLOCK_DATA));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BlockData->QuestionId = IfrCheckBox->Question.QuestionId;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync InitializeListHead (&BlockData->DefaultValueEntry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Add Block Data into VarStorageData BlockEntry
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync InsertBlockData (&VarStorageData->BlockEntry, &BlockData);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Add default value for standard ID by CheckBox Flag
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Prepare new DefaultValue
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((IfrCheckBox->Flags & EFI_IFR_CHECKBOX_DEFAULT) == EFI_IFR_CHECKBOX_DEFAULT) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // When flag is set, defautl value is TRUE.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // When flag is not set, defautl value is FASLE.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Add DefaultValue into current BlockData
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Add default value for Manufacture ID by CheckBox Flag
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync VarDefaultId = EFI_HII_DEFAULT_CLASS_MANUFACTURING;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Prepare new DefaultValue
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((IfrCheckBox->Flags & EFI_IFR_CHECKBOX_DEFAULT_MFG) == EFI_IFR_CHECKBOX_DEFAULT_MFG) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // When flag is set, defautl value is TRUE.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // When flag is not set, defautl value is FASLE.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Add DefaultValue into current BlockData
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // offset by question header
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // width MaxSize * sizeof (CHAR16)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // no default value, only block array
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // String question is not in IFR Form. This IFR form is not valid.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check whether this question is for the requested varstore.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (IfrString->Question.VarStoreId != VarStorageData->VarStoreId) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get Offset/Width by Question header and OneOf Flags
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync VarOffset = IfrString->Question.VarStoreInfo.VarOffset;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync VarWidth = (UINT16) (IfrString->MaxSize * sizeof (UINT16));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check whether this question is in requested block array.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!BlockArrayCheck (RequestBlockArray, VarOffset, VarWidth)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // This question is not in the requested string. Skip it.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check this var question is in the var storage
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((VarOffset + VarWidth) > VarStorageData->Size) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Set Block Data
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BlockData = (IFR_BLOCK_DATA *) AllocateZeroPool (sizeof (IFR_BLOCK_DATA));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BlockData->QuestionId = IfrString->Question.QuestionId;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync InitializeListHead (&BlockData->DefaultValueEntry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Add Block Data into VarStorageData BlockEntry
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync InsertBlockData (&VarStorageData->BlockEntry, &BlockData);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // No default value for string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // offset by question header
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // width MaxSize * sizeof (CHAR16)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // no default value, only block array
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Password question is not in IFR Form. This IFR form is not valid.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check whether this question is for the requested varstore.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (IfrPassword->Question.VarStoreId != VarStorageData->VarStoreId) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get Offset/Width by Question header and OneOf Flags
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync VarOffset = IfrPassword->Question.VarStoreInfo.VarOffset;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync VarWidth = (UINT16) (IfrPassword->MaxSize * sizeof (UINT16));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check whether this question is in requested block array.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!BlockArrayCheck (RequestBlockArray, VarOffset, VarWidth)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // This question is not in the requested string. Skip it.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check this var question is in the var storage
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((VarOffset + VarWidth) > VarStorageData->Size) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Set Block Data
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BlockData = (IFR_BLOCK_DATA *) AllocateZeroPool (sizeof (IFR_BLOCK_DATA));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BlockData->QuestionId = IfrPassword->Question.QuestionId;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync InitializeListHead (&BlockData->DefaultValueEntry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Add Block Data into VarStorageData BlockEntry
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync InsertBlockData (&VarStorageData->BlockEntry, &BlockData);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // No default value for string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // No matched block data is ignored.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IfrOneOfOption = (EFI_IFR_ONE_OF_OPTION *) IfrOpHdr;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (BlockData->OpCode == EFI_IFR_ORDERED_LIST_OP) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get ordered list option data type.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (IfrOneOfOption->Type == EFI_IFR_TYPE_NUM_SIZE_8 || IfrOneOfOption->Type == EFI_IFR_TYPE_BOOLEAN) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync } else if (IfrOneOfOption->Type == EFI_IFR_TYPE_NUM_SIZE_16) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync } else if (IfrOneOfOption->Type == EFI_IFR_TYPE_NUM_SIZE_32) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync } else if (IfrOneOfOption->Type == EFI_IFR_TYPE_NUM_SIZE_64) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Invalid ordered list option data type.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Calculate Ordered list QuestionId width.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BlockData->Width = (UINT16) (BlockData->Width * VarWidth);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check whether this question is in requested block array.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!BlockArrayCheck (RequestBlockArray, BlockData->Offset, BlockData->Width)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // This question is not in the requested string. Skip it.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check this var question is in the var storage
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((BlockData->Offset + BlockData->Width) > VarStorageData->Size) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Add Block Data into VarStorageData BlockEntry
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync InsertBlockData (&VarStorageData->BlockEntry, &BlockData);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // No default data for OrderedList.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // 1. Set default value for OneOf option when flag field has default attribute.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (((IfrOneOfOption->Flags & EFI_IFR_OPTION_DEFAULT) == EFI_IFR_OPTION_DEFAULT) ||
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ((IfrOneOfOption->Flags & EFI_IFR_OPTION_DEFAULT_MFG) == EFI_IFR_OPTION_DEFAULT_MFG)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // This flag is used to specify whether this option is the first. Set it to FALSE for the following options.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // The first oneof option value will be used as default value when no default value is specified.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Prepare new DefaultValue
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync CopyMem (&DefaultData.Value.u64, &IfrOneOfOption->Value.u64, sizeof (UINT64));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((IfrOneOfOption->Flags & EFI_IFR_OPTION_DEFAULT) == EFI_IFR_OPTION_DEFAULT) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DefaultData.DefaultId = EFI_HII_DEFAULT_CLASS_STANDARD;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((IfrOneOfOption->Flags & EFI_IFR_OPTION_DEFAULT_MFG) == EFI_IFR_OPTION_DEFAULT_MFG) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DefaultData.DefaultId = EFI_HII_DEFAULT_CLASS_MANUFACTURING;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // 2. Set as the default value when this is the first option.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // The first oneof option value will be used as default value when no default value is specified.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // This flag is used to specify whether this option is the first. Set it to FALSE for the following options.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Prepare new DefaultValue
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync CopyMem (&DefaultData.Value.u64, &IfrOneOfOption->Value.u64, sizeof (UINT64));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (LinkData = DefaultIdArray->Entry.ForwardLink; LinkData != &DefaultIdArray->Entry; LinkData = LinkData->ForwardLink) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DefaultDataPtr = BASE_CR (LinkData, IFR_DEFAULT_DATA, Entry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Update Current BlockData to the default value.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // No matched block data is ignored.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (BlockData->OpCode == EFI_IFR_ORDERED_LIST_OP) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // OrderedList Opcode is no default value.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get the DefaultId
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Prepare new DefaultValue
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync CopyMem (&DefaultData.Value, &IfrDefault->Value, sizeof (EFI_IFR_TYPE_VALUE));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // If the value field is expression, set the cleaned flag.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Add DefaultValue into current BlockData
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // After insert the default value, reset the cleaned value for next
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // time used. If not set here, need to set the value before everytime
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // End Opcode is for Var question.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BlockData->Scope = (UINT8) (BlockData->Scope + IfrOpHdr->Scope);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (LinkData = VarStorageData->BlockEntry.ForwardLink; LinkData != &VarStorageData->BlockEntry; LinkData = LinkData->ForwardLink) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BlockData = BASE_CR (LinkData, IFR_BLOCK_DATA, Entry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (LinkDefault = BlockData->DefaultValueEntry.ForwardLink; LinkDefault != &BlockData->DefaultValueEntry; ) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DefaultDataPtr = BASE_CR (LinkDefault, IFR_DEFAULT_DATA, Entry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This function gets the full request string and full default value string by
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync parsing IFR data in HII form packages.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync When Request points to NULL string, the request string and default value string
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for each varstore in form package will return.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param DataBaseRecord The DataBaseRecord instance contains the found Hii handle and package.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param DevicePath Device Path which Hii Config Access Protocol is registered.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Request Pointer to a null-terminated Unicode string in
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync <ConfigRequest> format. When it doesn't contain
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync any RequestElement, it will be updated to return
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync the full RequestElement retrieved from IFR data.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync If it points to NULL, the request string for the first
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync varstore in form package will be merged into a
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync <MultiConfigRequest> format string and return.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param AltCfgResp Pointer to a null-terminated Unicode string in
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync <ConfigAltResp> format. When the pointer is to NULL,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync the full default value string retrieved from IFR data
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync will return. When the pinter is to a string, the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync full default value string retrieved from IFR data
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync will be merged into the input string and return.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync When Request points to NULL, the default value string
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for each varstore in form package will be merged into
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync a <MultiConfigAltResp> format string and return.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param PointerProgress Optional parameter, it can be be NULL.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync When it is not NULL, if Request is NULL, it returns NULL.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync On return, points to a character in the Request
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync string. Points to the string's null terminator if
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync request was successful. Points to the most recent
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync & before the first failing name / value pair (or
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync the beginning of the string if the failure is in
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync the first name / value pair) if the request was
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync not successful.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS The Results string is set to the full request string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync And AltCfgResp contains all default value string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_OUT_OF_RESOURCES Not enough memory for the return string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_NOT_FOUND The varstore (Guid and Name) in Request string
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync can't be found in Form package.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_NOT_FOUND HiiPackage can't be got on the input HiiHandle.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER Request points to NULL.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (DataBaseRecord == NULL || DevicePath == NULL || Request == NULL || AltCfgResp == NULL) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Initialize the local variables.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = GetFormPackageData (DataBaseRecord, &HiiFormPackage, &PackageSize);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // 1. Get the request block array by Request String when Request string containts the block array.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Jump <ConfigHdr>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (StrnCmp (StringPtr, L"GUID=", StrLen (L"GUID=")) != 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync while (*StringPtr != L'\0' && StrnCmp (StringPtr, L"&NAME=", StrLen (L"&NAME=")) != 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync while (*StringPtr != L'\0' && StrnCmp (StringPtr, L"&PATH=", StrLen (L"&PATH=")) != 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync while (*StringPtr != L'\0' && *StringPtr != L'&') {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check the following string &OFFSET=
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (*StringPtr != L'\0' && StrnCmp (StringPtr, L"&OFFSET=", StrLen (L"&OFFSET=")) != 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // No request block is found.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Init RequestBlockArray
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RequestBlockArray = (IFR_BLOCK_DATA *) AllocateZeroPool (sizeof (IFR_BLOCK_DATA));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get the request Block array from the request string
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Offset and Width
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Parse each <RequestElement> if exists
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Only <BlockName> format is supported by this help function.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // <BlockName> ::= &'OFFSET='<Number>&'WIDTH='<Number>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync while (*StringPtr != 0 && StrnCmp (StringPtr, L"&OFFSET=", StrLen (L"&OFFSET=")) == 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Skip the OFFSET string
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get Offset
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = GetValueOfNumber (StringPtr, &TmpBuffer, &Length);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync (((Length + 1) / 2) < sizeof (UINT16)) ? ((Length + 1) / 2) : sizeof (UINT16)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (StrnCmp (StringPtr, L"&WIDTH=", StrLen (L"&WIDTH=")) != 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get Width
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = GetValueOfNumber (StringPtr, &TmpBuffer, &Length);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync (((Length + 1) / 2) < sizeof (UINT16)) ? ((Length + 1) / 2) : sizeof (UINT16)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Set Block Data
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BlockData = (IFR_BLOCK_DATA *) AllocateZeroPool (sizeof (IFR_BLOCK_DATA));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync InsertBlockData (&RequestBlockArray->Entry, &BlockData);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Skip &VALUE string if &VALUE does exists.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (StrnCmp (StringPtr, L"&VALUE=", StrLen (L"&VALUE=")) == 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get Value
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = GetValueOfNumber (StringPtr, &TmpBuffer, &Length);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // If '\0', parsing is finished.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Merge the requested block data.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync while ((Link != &RequestBlockArray->Entry) && (Link->ForwardLink != &RequestBlockArray->Entry)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync NextBlockData = BASE_CR (Link->ForwardLink, IFR_BLOCK_DATA, Entry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((NextBlockData->Offset >= BlockData->Offset) && (NextBlockData->Offset <= (BlockData->Offset + BlockData->Width))) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((NextBlockData->Offset + NextBlockData->Width) > (BlockData->Offset + BlockData->Width)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BlockData->Width = (UINT16) (NextBlockData->Offset + NextBlockData->Width - BlockData->Offset);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // 2. Parse FormPackage to get BlockArray and DefaultId Array for the request BlockArray.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Initialize DefaultIdArray to store the map between DeaultId and DefaultName
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DefaultIdArray = (IFR_DEFAULT_DATA *) AllocateZeroPool (sizeof (IFR_DEFAULT_DATA));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Initialize VarStorageData to store the var store Block and Default value information.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync VarStorageData = (IFR_VARSTORAGE_DATA *) AllocateZeroPool (sizeof (IFR_VARSTORAGE_DATA));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Parse the opcode in form pacakge to get the default setting.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = ParseIfrData (HiiFormPackage, (UINT32) PackageSize, *Request, RequestBlockArray, VarStorageData, DefaultIdArray);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // No requested varstore in IFR data and directly return
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // 3. Construct Request Element (Block Name) for 2.1 and 2.2 case.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Construct <ConfigHdr> : "GUID=...&NAME=...&PATH=..." by VarStorageData Guid, Name and DriverHandle
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync GenerateSubStr (L"GUID=", sizeof (EFI_GUID), (VOID *) &VarStorageData->Guid, 1, &GuidStr);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync GenerateSubStr (L"NAME=", StrLen (VarStorageData->Name) * sizeof (CHAR16), (VOID *) VarStorageData->Name, 2, &NameStr);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync GetDevicePathSize ((EFI_DEVICE_PATH_PROTOCOL *) DevicePath),
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ConfigHdr = AllocateZeroPool (Length * sizeof (CHAR16));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Remove the last character L'&'
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Append VarStorageData BlockEntry into *Request string
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Now support only one varstore in a form package.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Go through all VarStorageData Entry and get BlockEntry for each one for the multiple varstore in a single form package
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Then construct them all to return MultiRequest string : ConfigHdr BlockConfig
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Compute the length of the entire request starting with <ConfigHdr> and a
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Null-terminator
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (Link = VarStorageData->BlockEntry.ForwardLink; Link != &VarStorageData->BlockEntry; Link = Link->ForwardLink) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Add <BlockName> length for each Offset/Width pair
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // <BlockName> ::= &OFFSET=1234&WIDTH=1234
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // | 8 | 4 | 7 | 4 |
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // No any request block data is found. The request string can't be constructed.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Allocate buffer for the entire <ConfigRequest>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync FullConfigRequest = AllocateZeroPool (Length * sizeof (CHAR16));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Start with <ConfigHdr>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Loop through all the Offset/Width pairs and append them to ConfigRequest
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (Link = VarStorageData->BlockEntry.ForwardLink; Link != &VarStorageData->BlockEntry; Link = Link->ForwardLink) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Append &OFFSET=XXXX&WIDTH=YYYY\0
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync L"&OFFSET=%04X&WIDTH=%04X",
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Set to the got full request string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // 4. Construct Default Value string in AltResp according to request element.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Go through all VarStorageData Entry and get the DefaultId array for each one
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Then construct them all to : ConfigHdr AltConfigHdr ConfigBody AltConfigHdr ConfigBody
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Add length for <ConfigHdr> + '\0'
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (Link = DefaultIdArray->Entry.ForwardLink; Link != &DefaultIdArray->Entry; Link = Link->ForwardLink) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DefaultId = BASE_CR (Link, IFR_DEFAULT_DATA, Entry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Add length for "&<ConfigHdr>&ALTCFG=XXXX"
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // |1| StrLen (ConfigHdr) | 8 | 4 |
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (LinkData = VarStorageData->BlockEntry.ForwardLink; LinkData != &VarStorageData->BlockEntry; LinkData = LinkData->ForwardLink) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BlockData = BASE_CR (LinkData, IFR_BLOCK_DATA, Entry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (LinkDefault = BlockData->DefaultValueEntry.ForwardLink; LinkDefault != &BlockData->DefaultValueEntry; LinkDefault = LinkDefault->ForwardLink) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DefaultValueData = BASE_CR (LinkDefault, IFR_DEFAULT_DATA, Entry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (DefaultValueData->DefaultId == DefaultId->DefaultId) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Add length for "&OFFSET=XXXX&WIDTH=YYYY&VALUE=zzzzzzzzzzzz"
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // | 8 | 4 | 7 | 4 | 7 | Width * 2 |
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Length += (8 + 4 + 7 + 4 + 7 + BlockData->Width * 2);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // No default value is found. The default string doesn't exist.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Allocate buffer for the entire <DefaultAltCfgResp>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DefaultAltCfgResp = AllocateZeroPool (Length * sizeof (CHAR16));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Start with <ConfigHdr>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (Link = DefaultIdArray->Entry.ForwardLink; Link != &DefaultIdArray->Entry; Link = Link->ForwardLink) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DefaultId = BASE_CR (Link, IFR_DEFAULT_DATA, Entry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Add <AltConfigHdr> of the form "&<ConfigHdr>&ALTCFG=XXXX\0"
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // |1| StrLen (ConfigHdr) | 8 | 4 |
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync (1 + StrLen (ConfigHdr) + 8 + 4 + 1) * sizeof (CHAR16),
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync L"&%s&ALTCFG=%04X",
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (LinkData = VarStorageData->BlockEntry.ForwardLink; LinkData != &VarStorageData->BlockEntry; LinkData = LinkData->ForwardLink) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BlockData = BASE_CR (LinkData, IFR_BLOCK_DATA, Entry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (LinkDefault = BlockData->DefaultValueEntry.ForwardLink; LinkDefault != &BlockData->DefaultValueEntry; LinkDefault = LinkDefault->ForwardLink) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DefaultValueData = BASE_CR (LinkDefault, IFR_DEFAULT_DATA, Entry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (DefaultValueData->DefaultId == DefaultId->DefaultId) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Add <BlockConfig>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // <BlockConfig> ::= 'OFFSET='<Number>&'WIDTH='<Number>&'VALUE'=<Number>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync L"&OFFSET=%04X&WIDTH=%04X&VALUE=",
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Convert Value to a hex string in "%x" format
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // NOTE: This is in the opposite byte that GUID and PATH use
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync StringPtr += UnicodeValueToString (StringPtr, PREFIX_ZERO | RADIX_HEX, TmpBuffer[Width - 1], 2);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // 5. Merge string into the input AltCfgResp if the iput *AltCfgResp is not NULL.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (*AltCfgResp != NULL && DefaultAltCfgResp != NULL) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = MergeDefaultString (AltCfgResp, DefaultAltCfgResp);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Free Link Array RequestBlockArray
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BlockData = BASE_CR (RequestBlockArray->Entry.ForwardLink, IFR_BLOCK_DATA, Entry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Free link array VarStorageData
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync while (!IsListEmpty (&VarStorageData->BlockEntry)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BlockData = BASE_CR (VarStorageData->BlockEntry.ForwardLink, IFR_BLOCK_DATA, Entry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Free default value link array
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync while (!IsListEmpty (&BlockData->DefaultValueEntry)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DefaultValueData = BASE_CR (BlockData->DefaultValueEntry.ForwardLink, IFR_DEFAULT_DATA, Entry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Free DefaultId Array
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DefaultId = BASE_CR (DefaultIdArray->Entry.ForwardLink, IFR_DEFAULT_DATA, Entry);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Free the allocated string
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Free Pacakge data
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This function gets the full request resp string by
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync parsing IFR data in HII form packages.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param This A pointer to the EFI_HII_CONFIG_ROUTING_PROTOCOL
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param EfiVarStoreInfo The efi varstore info which is save in the EFI
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync varstore data structure.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Request Pointer to a null-terminated Unicode string in
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync <ConfigRequest> format.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param RequestResp Pointer to a null-terminated Unicode string in
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync <ConfigResp> format.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param AccessProgress On return, points to a character in the Request
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync string. Points to the string's null terminator if
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync request was successful. Points to the most recent
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync & before the first failing name / value pair (or
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync the beginning of the string if the failure is in
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync the first name / value pair) if the request was
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync not successful.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS The Results string is set to the full request string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync And AltCfgResp contains all default value string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_OUT_OF_RESOURCES Not enough memory for the return string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER Request points to NULL.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync VarStoreName = AllocateZeroPool (AsciiStrSize ((CHAR8 *)EfiVarStoreInfo->Name) * sizeof (CHAR16));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync AsciiStrToUnicodeStr ((CHAR8 *) EfiVarStoreInfo->Name, VarStoreName);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = gRT->GetVariable (VarStoreName, &EfiVarStoreInfo->Guid, NULL, &BufferSize, NULL);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = gRT->GetVariable (VarStoreName, &EfiVarStoreInfo->Guid, NULL, &BufferSize, VarStore);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = HiiBlockToConfig(This, Request, VarStore, BufferSize, RequestResp, AccessProgress);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This function route the full request resp string for efi varstore.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param This A pointer to the EFI_HII_CONFIG_ROUTING_PROTOCOL
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param EfiVarStoreInfo The efi varstore info which is save in the EFI
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync varstore data structure.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param RequestResp Pointer to a null-terminated Unicode string in
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync <ConfigResp> format.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Result Pointer to a null-terminated Unicode string in
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync <ConfigResp> format.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS The Results string is set to the full request string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync And AltCfgResp contains all default value string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_OUT_OF_RESOURCES Not enough memory for the return string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER Request points to NULL.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync VarStoreName = AllocateZeroPool (AsciiStrSize ((CHAR8 *)EfiVarStoreInfo->Name) * sizeof (CHAR16));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync AsciiStrToUnicodeStr ((CHAR8 *) EfiVarStoreInfo->Name, VarStoreName);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = gRT->GetVariable (VarStoreName, &EfiVarStoreInfo->Guid, NULL, &BufferSize, NULL);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = gRT->GetVariable (VarStoreName, &EfiVarStoreInfo->Guid, NULL, &BufferSize, VarStore);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = HiiConfigToBlock(This, RequestResp, VarStore, &BlockSize, Result);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = gRT->SetVariable (VarStoreName, &EfiVarStoreInfo->Guid, EfiVarStoreInfo->Attributes, BufferSize, VarStore);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This function allows a caller to extract the current configuration
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for one or more named elements from one or more drivers.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param This A pointer to the EFI_HII_CONFIG_ROUTING_PROTOCOL
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Request A null-terminated Unicode string in
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync <MultiConfigRequest> format.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Progress On return, points to a character in the Request
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync string. Points to the string's null terminator if
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync request was successful. Points to the most recent
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync & before the first failing name / value pair (or
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync the beginning of the string if the failure is in
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync the first name / value pair) if the request was
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync not successful.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Results Null-terminated Unicode string in
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync <MultiConfigAltResp> format which has all values
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync filled in for the names in the Request string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync String to be allocated by the called function.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS The Results string is filled with the values
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync corresponding to all requested names.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_OUT_OF_RESOURCES Not enough memory to store the parts of the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync results that must be stored awaiting possible
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync future protocols.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_NOT_FOUND Routing data doesn't match any known driver.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Progress set to the "G" in "GUID" of the routing
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync header that doesn't match. Note: There is no
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync requirement that all routing data be validated
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync before any configuration extraction.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER For example, passing in a NULL for the Request
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync parameter would result in this type of error. The
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Progress parameter is set to NULL.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER Illegal syntax. Progress set to most recent &
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync before the error or the beginning of the string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER Unknown name. Progress points to the & before the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync name in question.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (This == NULL || Progress == NULL || Results == NULL) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Private = CONFIG_ROUTING_DATABASE_PRIVATE_DATA_FROM_THIS (This);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // The first element of <MultiConfigRequest> should be
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // <GuidHdr>, which is in 'GUID='<Guid> syntax.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (StrnCmp (StringPtr, L"GUID=", StrLen (L"GUID=")) != 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Allocate a fix length of memory to store Results. Reallocate memory for
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Results if this fix length is insufficient.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *Results = (EFI_STRING) AllocateZeroPool (MAX_STRING_LENGTH);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync while (*StringPtr != 0 && StrnCmp (StringPtr, L"GUID=", StrLen (L"GUID=")) == 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // If parsing error, set Progress to the beginning of the <MultiConfigRequest>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // or most recent & before the error.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Process each <ConfigRequest> of <MultiConfigRequest>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ConfigRequest = AllocateCopyPool ((Length + 1) * sizeof (CHAR16), StringPtr);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get the UEFI device path
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = GetDevicePath (ConfigRequest, (UINT8 **) &DevicePath);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Find driver which matches the routing data.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Database = CR (Link, HII_DATABASE_RECORD, DatabaseEntry, HII_DATABASE_RECORD_SIGNATURE);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((DevicePathPkg = Database->PackageList->DevicePathPkg) != NULL) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync CurrentDevicePath = DevicePathPkg + sizeof (EFI_HII_PACKAGE_HEADER);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync GetDevicePathSize ((EFI_DEVICE_PATH_PROTOCOL *) CurrentDevicePath)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Try to find driver handle by device path.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (EFI_ERROR (Status) || (DriverHandle == NULL)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Routing data does not match any known driver.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Set Progress to the 'G' in "GUID" of the routing header.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check whether ConfigRequest contains request string OFFSET/WIDTH
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((HiiHandle != NULL) && (StrStr (ConfigRequest, L"&OFFSET=") == NULL)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get the full request string from IFR when HiiPackage is registered to HiiHandle
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = GetFullStringFromHiiFormPackages (Database, DevicePath, &ConfigRequest, &DefaultResults, &AccessProgress);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // AccessProgress indicates the parsing progress on <ConfigRequest>.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Map it to the progress on <MultiConfigRequest> then return it.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Not any request block is found.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync AccessResults = AllocateCopyPool (StrSize (ConfigRequest), ConfigRequest);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check whether this ConfigRequest is search from Efi varstore type storage.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = GetVarStoreType(Database, ConfigRequest, &IsEfiVarStore, &EfiVarStoreInfo);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Call the GetVariable function to extract settings.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = GetConfigRespFromEfiVarStore(This, EfiVarStoreInfo, ConfigRequest, &AccessResults, &AccessProgress);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Call corresponding ConfigAccess protocol to extract settings
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // AccessProgress indicates the parsing progress on <ConfigRequest>.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Map it to the progress on <MultiConfigRequest> then return it.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Attach this <ConfigAltResp> to a <MultiConfigAltResp>. There is a '&'
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // which seperates the first <ConfigAltResp> and the following ones.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Update AccessResults by getting default setting from IFR when HiiPackage is registered to HiiHandle
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = GetFullStringFromHiiFormPackages (Database, DevicePath, &ConfigRequest, &DefaultResults, NULL);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = MergeDefaultString (&AccessResults, DefaultResults);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = AppendToMultiString (Results, AccessResults);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Go to next <ConfigRequest> (skip '&').
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This function allows the caller to request the current configuration for the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync entirety of the current HII database and returns the data in a
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync null-terminated Unicode string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param This A pointer to the EFI_HII_CONFIG_ROUTING_PROTOCOL
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Results Null-terminated Unicode string in
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync <MultiConfigAltResp> format which has all values
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync filled in for the names in the Request string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync String to be allocated by the called function.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync De-allocation is up to the caller.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS The Results string is filled with the values
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync corresponding to all requested names.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_OUT_OF_RESOURCES Not enough memory to store the parts of the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync results that must be stored awaiting possible
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync future protocols.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER For example, passing in a NULL for the Results
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync parameter would result in this type of error.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Private = CONFIG_ROUTING_DATABASE_PRIVATE_DATA_FROM_THIS (This);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Allocate a fix length of memory to store Results. Reallocate memory for
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Results if this fix length is insufficient.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *Results = (EFI_STRING) AllocateZeroPool (MAX_STRING_LENGTH);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (Index = 0; Index < NumberConfigAccessHandles; Index++) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get DevicePath and HiiHandle for this ConfigAccess driver handle
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DevicePath = DevicePathFromHandle (ConfigAccessHandles[Index]);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Database = CR (Link, HII_DATABASE_RECORD, DatabaseEntry, HII_DATABASE_RECORD_SIGNATURE);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((DevicePathPkg = Database->PackageList->DevicePathPkg) != NULL) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync CurrentDevicePath = DevicePathPkg + sizeof (EFI_HII_PACKAGE_HEADER);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync GetDevicePathSize ((EFI_DEVICE_PATH_PROTOCOL *) CurrentDevicePath)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Update AccessResults by getting default setting from IFR when HiiPackage is registered to HiiHandle
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = GetFullStringFromHiiFormPackages (Database, DevicePath, &ConfigRequest, &DefaultResults, NULL);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get the full request string to get the Current setting again.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!EFI_ERROR (Status) && ConfigRequest != NULL) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Update AccessResults by getting default setting from IFR when HiiPackage is registered to HiiHandle
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!IfrDataParsedFlag && HiiHandle != NULL && DevicePath != NULL) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = GetFullStringFromHiiFormPackages (Database, DevicePath, &AccessResults, &DefaultResults, NULL);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Merge the default sting from IFR code into the got setting from driver.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = MergeDefaultString (&AccessResults, DefaultResults);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Attach this <ConfigAltResp> to a <MultiConfigAltResp>. There is a '&'
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // which seperates the first <ConfigAltResp> and the following ones.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = AppendToMultiString (Results, AccessResults);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This function processes the results of processing forms and routes it to the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync appropriate handlers or storage.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param This A pointer to the EFI_HII_CONFIG_ROUTING_PROTOCOL
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Configuration A null-terminated Unicode string in
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync <MulltiConfigResp> format.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Progress A pointer to a string filled in with the offset of
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync the most recent & before the first failing name /
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync value pair (or the beginning of the string if the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync failure is in the first name / value pair) or the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync terminating NULL if all was successful.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS The results have been distributed or are awaiting
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync distribution.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_OUT_OF_RESOURCES Not enough memory to store the parts of the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync results that must be stored awaiting possible
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync future protocols.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER Passing in a NULL for the Configuration parameter
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync would result in this type of error.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_NOT_FOUND Target for the specified routing data was not
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Private = CONFIG_ROUTING_DATABASE_PRIVATE_DATA_FROM_THIS (This);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // The first element of <MultiConfigResp> should be
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // <GuidHdr>, which is in 'GUID='<Guid> syntax.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (StrnCmp (StringPtr, L"GUID=", StrLen (L"GUID=")) != 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync while (*StringPtr != 0 && StrnCmp (StringPtr, L"GUID=", StrLen (L"GUID=")) == 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // If parsing error, set Progress to the beginning of the <MultiConfigResp>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // or most recent & before the error.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Process each <ConfigResp> of <MultiConfigResp>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ConfigResp = AllocateCopyPool ((Length + 1) * sizeof (CHAR16), StringPtr);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Append '\0' to the end of ConfigRequest
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get the UEFI device path
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = GetDevicePath (ConfigResp, (UINT8 **) &DevicePath);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Find driver which matches the routing data.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Database = CR (Link, HII_DATABASE_RECORD, DatabaseEntry, HII_DATABASE_RECORD_SIGNATURE);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((DevicePathPkg = Database->PackageList->DevicePathPkg) != NULL) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync CurrentDevicePath = DevicePathPkg + sizeof (EFI_HII_PACKAGE_HEADER);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync GetDevicePathSize ((EFI_DEVICE_PATH_PROTOCOL *) CurrentDevicePath)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Try to find driver handle by device path.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (EFI_ERROR (Status) || (DriverHandle == NULL)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Routing data does not match any known driver.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Set Progress to the 'G' in "GUID" of the routing header.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check whether this ConfigRequest is search from Efi varstore type storage.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = GetVarStoreType(Database, ConfigResp, &IsEfiVarstore, &EfiVarStoreInfo);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Call the SetVariable function to route settings.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = RouteConfigRespForEfiVarStore(This, EfiVarStoreInfo, ConfigResp, &AccessProgress);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Call corresponding ConfigAccess protocol to route settings
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // AccessProgress indicates the parsing progress on <ConfigResp>.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Map it to the progress on <MultiConfigResp> then return it.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Go to next <ConfigResp> (skip '&').
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This helper function is to be called by drivers to map configuration data
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync stored in byte array ("block") formats such as UEFI Variables into current
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync configuration strings.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param This A pointer to the EFI_HII_CONFIG_ROUTING_PROTOCOL
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param ConfigRequest A null-terminated Unicode string in
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync <ConfigRequest> format.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Block Array of bytes defining the block's configuration.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param BlockSize Length in bytes of Block.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Config Filled-in configuration string. String allocated
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync by the function. Returned only if call is
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync successful. It is <ConfigResp> string format.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Progress A pointer to a string filled in with the offset of
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync the most recent & before the first failing
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync name/value pair (or the beginning of the string if
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync the failure is in the first name / value pair) or
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync the terminating NULL if all was successful.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS The request succeeded. Progress points to the null
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync terminator at the end of the ConfigRequest
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_OUT_OF_RESOURCES Not enough memory to allocate Config. Progress
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync points to the first character of ConfigRequest.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER Passing in a NULL for the ConfigRequest or
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Block parameter would result in this type of
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync error. Progress points to the first character of
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ConfigRequest.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_DEVICE_ERROR Block not large enough. Progress undefined.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER Encountered non <BlockName> formatted string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Block is left updated and Progress points at
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync the "&" preceding the first non-<BlockName>.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (This == NULL || Progress == NULL || Config == NULL) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Private = CONFIG_ROUTING_DATABASE_PRIVATE_DATA_FROM_THIS (This);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Allocate a fix length of memory to store Results. Reallocate memory for
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Results if this fix length is insufficient.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *Config = (EFI_STRING) AllocateZeroPool (MAX_STRING_LENGTH);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Jump <ConfigHdr>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (StrnCmp (StringPtr, L"GUID=", StrLen (L"GUID=")) != 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync while (*StringPtr != 0 && StrnCmp (StringPtr, L"PATH=", StrLen (L"PATH=")) != 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Skip '&'
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Copy <ConfigHdr> and an additional '&' to <ConfigResp>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Parse each <RequestElement> if exists
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Only <BlockName> format is supported by this help function.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // <BlockName> ::= 'OFFSET='<Number>&'WIDTH='<Number>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync while (*StringPtr != 0 && StrnCmp (StringPtr, L"OFFSET=", StrLen (L"OFFSET=")) == 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Back up the header of one <BlockName>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get Offset
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = GetValueOfNumber (StringPtr, &TmpBuffer, &Length);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync (((Length + 1) / 2) < sizeof (UINTN)) ? ((Length + 1) / 2) : sizeof (UINTN)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (StrnCmp (StringPtr, L"&WIDTH=", StrLen (L"&WIDTH=")) != 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *Progress = StringPtr - Length - StrLen (L"OFFSET=") - 1;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get Width
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = GetValueOfNumber (StringPtr, &TmpBuffer, &Length);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync (((Length + 1) / 2) < sizeof (UINTN)) ? ((Length + 1) / 2) : sizeof (UINTN)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *Progress = StringPtr - Length - StrLen (L"&WIDTH=");
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Calculate Value and convert it to hex string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ValueStr = (EFI_STRING) AllocateZeroPool (Length * sizeof (CHAR16));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (Index = 0; Index < Width; Index ++, TemBuffer --) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync TemString += UnicodeValueToString (TemString, PREFIX_ZERO | RADIX_HEX, *TemBuffer, 2);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Build a ConfigElement
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Length += StringPtr - TmpPtr + 1 + StrLen (L"VALUE=");
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ConfigElement = (EFI_STRING) AllocateZeroPool (Length * sizeof (CHAR16));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync CopyMem (ConfigElement, TmpPtr, (StringPtr - TmpPtr + 1) * sizeof (CHAR16));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // If '\0', parsing is finished. Otherwise skip '&' to continue
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This helper function is to be called by drivers to map configuration strings
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync to configurations stored in byte array ("block") formats such as UEFI Variables.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param This A pointer to the EFI_HII_CONFIG_ROUTING_PROTOCOL
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param ConfigResp A null-terminated Unicode string in <ConfigResp>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Block A possibly null array of bytes representing the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync current block. Only bytes referenced in the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ConfigResp string in the block are modified. If
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync this parameter is null or if the *BlockSize
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync parameter is (on input) shorter than required by
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync the Configuration string, only the BlockSize
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync parameter is updated and an appropriate status
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync (see below) is returned.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param BlockSize The length of the Block in units of UINT8. On
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync input, this is the size of the Block. On output,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if successful, contains the index of the last
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync modified byte in the Block.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Progress On return, points to an element of the ConfigResp
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync string filled in with the offset of the most
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync recent '&' before the first failing name / value
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync pair (or the beginning of the string if the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync failure is in the first name / value pair) or the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync terminating NULL if all was successful.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS The request succeeded. Progress points to the null
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync terminator at the end of the ConfigResp string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_OUT_OF_RESOURCES Not enough memory to allocate Config. Progress
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync points to the first character of ConfigResp.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER Passing in a NULL for the ConfigResp or
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Block parameter would result in this type of
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync error. Progress points to the first character of
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ConfigResp.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER Encountered non <BlockName> formatted name /
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync value pair. Block is left updated and
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Progress points at the '&' preceding the first
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync non-<BlockName>.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_DEVICE_ERROR Block not large enough. Progress undefined.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_NOT_FOUND Target for the specified routing data was not found.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Progress points to the "G" in "GUID" of the errant
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync routing data.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (This == NULL || BlockSize == NULL || Progress == NULL) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Private = CONFIG_ROUTING_DATABASE_PRIVATE_DATA_FROM_THIS (This);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Jump <ConfigHdr>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (StrnCmp (StringPtr, L"GUID=", StrLen (L"GUID=")) != 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync while (*StringPtr != 0 && StrnCmp (StringPtr, L"PATH=", StrLen (L"PATH=")) != 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Skip '&'
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Parse each <ConfigElement> if exists
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Only <BlockConfig> format is supported by this help function.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // <BlockConfig> ::= 'OFFSET='<Number>&'WIDTH='<Number>&'VALUE='<Number>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync while (*StringPtr != 0 && StrnCmp (StringPtr, L"OFFSET=", StrLen (L"OFFSET=")) == 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get Offset
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = GetValueOfNumber (StringPtr, &TmpBuffer, &Length);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync (((Length + 1) / 2) < sizeof (UINTN)) ? ((Length + 1) / 2) : sizeof (UINTN)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (StrnCmp (StringPtr, L"&WIDTH=", StrLen (L"&WIDTH=")) != 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *Progress = StringPtr - Length - StrLen (L"OFFSET=") - 1;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get Width
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = GetValueOfNumber (StringPtr, &TmpBuffer, &Length);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync (((Length + 1) / 2) < sizeof (UINTN)) ? ((Length + 1) / 2) : sizeof (UINTN)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (StrnCmp (StringPtr, L"&VALUE=", StrLen (L"&VALUE=")) != 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *Progress = StringPtr - Length - StrLen (L"&WIDTH=");
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get Value
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = GetValueOfNumber (StringPtr, &Value, &Length);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Update the Block with configuration info
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((Block != NULL) && (Offset + Width <= BufferSize)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // If '\0', parsing is finished. Otherwise skip '&' to continue
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // The input string is ConfigAltResp format.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((*StringPtr != 0) && (StrnCmp (StringPtr, L"&GUID=", StrLen (L"&GUID=")) != 0)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This helper function is to be called by drivers to extract portions of
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync a larger configuration string.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param This A pointer to the EFI_HII_CONFIG_ROUTING_PROTOCOL
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Configuration A null-terminated Unicode string in
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync <MultiConfigAltResp> format.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Guid A pointer to the GUID value to search for in the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync routing portion of the ConfigResp string when
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync retrieving the requested data. If Guid is NULL,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync then all GUID values will be searched for.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Name A pointer to the NAME value to search for in the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync routing portion of the ConfigResp string when
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync retrieving the requested data. If Name is NULL,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync then all Name values will be searched for.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param DevicePath A pointer to the PATH value to search for in the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync routing portion of the ConfigResp string when
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync retrieving the requested data. If DevicePath is
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync NULL, then all DevicePath values will be searched
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param AltCfgId A pointer to the ALTCFG value to search for in the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync routing portion of the ConfigResp string when
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync retrieving the requested data. If this parameter
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync is NULL, then the current setting will be
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param AltCfgResp A pointer to a buffer which will be allocated by
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync the function which contains the retrieved string
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync as requested. This buffer is only allocated if
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync the call was successful. It is <ConfigResp> format.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS The request succeeded. The requested data was
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync extracted and placed in the newly allocated
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync AltCfgResp buffer.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_OUT_OF_RESOURCES Not enough memory to allocate AltCfgResp.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER Any parameter is invalid.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_NOT_FOUND Target for the specified routing data was not
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (This == NULL || Configuration == NULL || AltCfgResp == NULL) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (StrnCmp (StringPtr, L"GUID=", StrLen (L"GUID=")) != 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Generate the sub string for later matching.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync GenerateSubStr (L"GUID=", sizeof (EFI_GUID), (VOID *) Guid, 1, &GuidStr);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync GetDevicePathSize ((EFI_DEVICE_PATH_PROTOCOL *) DevicePath),
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync GenerateSubStr (L"ALTCFG=", sizeof (UINT16), (VOID *) AltCfgId, 3, &AltIdStr);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync GenerateSubStr (L"NAME=", StrLen (Name) * sizeof (CHAR16), (VOID *) Name, 2, &NameStr);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync while (*StringPtr != 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Try to match the GUID
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Jump to <NameHdr>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Try to match the NAME
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (StrnCmp (StringPtr, NameStr, StrLen (NameStr)) != 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Jump to <PathHdr>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Try to match the DevicePath
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (StrnCmp (StringPtr, PathStr, StrLen (PathStr)) != 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Jump to '&' before <DescHdr> or <ConfigBody>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Try to match the AltCfgId
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Return Current Setting when AltCfgId is NULL.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Search the <ConfigAltResp> to get the <AltResp> with AltCfgId.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (StrnCmp (StringPtr, AltIdStr, StrLen (AltIdStr)) != 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Skip AltIdStr and &
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Copy the <ConfigHdr> and <ConfigBody>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *AltCfgResp = AllocateZeroPool (Length * sizeof (CHAR16));