]> git.proxmox.com Git - mirror_edk2.git/blame - MdeModulePkg/Universal/Network/VlanConfigDxe/VlanConfigImpl.c
projects / mirror_edk2.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
Sync BaseTools Branch (version r2321) to EDKII main trunk.
[mirror_edk2.git] / MdeModulePkg / Universal / Network / VlanConfigDxe / VlanConfigImpl.c
CommitLineData
779ae357 1/** @file\r
2 HII Config Access protocol implementation of VLAN configuration module.\r
3\r
083f7c69 4Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.<BR>\r
e5eed7d3 5This program and the accompanying materials\r
779ae357 6are licensed and made available under the terms and conditions\r
7of the BSD License which accompanies this distribution. The full\r
8text of the license may be found at<BR>\r
9http://opensource.org/licenses/bsd-license.php\r
10\r
11THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
12WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
13\r
14**/\r
15\r
16#include "VlanConfigImpl.h"\r
17\r
18EFI_GUID mVlanFormSetGuid = VLAN_CONFIG_PRIVATE_GUID;\r
19CHAR16 mVlanStorageName[] = L"VlanNvData";\r
20EFI_HII_CONFIG_ROUTING_PROTOCOL *mHiiConfigRouting = NULL;\r
21\r
22VLAN_CONFIG_PRIVATE_DATA mVlanConfigPrivateDateTemplate = {\r
23 VLAN_CONFIG_PRIVATE_DATA_SIGNATURE,\r
24 {\r
25 VlanExtractConfig,\r
26 VlanRouteConfig,\r
27 VlanCallback\r
28 }\r
29};\r
30\r
31VENDOR_DEVICE_PATH mHiiVendorDevicePathNode = {\r
32 {\r
33 HARDWARE_DEVICE_PATH,\r
34 HW_VENDOR_DP,\r
35 {\r
36 (UINT8) (sizeof (VENDOR_DEVICE_PATH)),\r
37 (UINT8) ((sizeof (VENDOR_DEVICE_PATH)) >> 8)\r
38 }\r
39 },\r
40 VLAN_CONFIG_PRIVATE_GUID\r
41};\r
42\r
43/**\r
44 This function allows a caller to extract the current configuration for one\r
45 or more named elements from the target driver.\r
46\r
47 @param[in] This Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.\r
48 @param[in] Request A null-terminated Unicode string in\r
49 <ConfigRequest> format.\r
50 @param[out] Progress On return, points to a character in the Request\r
51 string. Points to the string's null terminator if\r
52 request was successful. Points to the most recent\r
53 '&' before the first failing name/value pair (or\r
54 the beginning of the string if the failure is in\r
55 the first name/value pair) if the request was not\r
56 successful.\r
57 @param[out] Results A null-terminated Unicode string in\r
58 <ConfigAltResp> format which has all values filled\r
59 in for the names in the Request string. String to\r
60 be allocated by the called function.\r
61\r
62 @retval EFI_SUCCESS The Results is filled with the requested values.\r
63 @retval EFI_OUT_OF_RESOURCES Not enough memory to store the results.\r
5a157365 64 @retval EFI_INVALID_PARAMETER Request is illegal syntax, or unknown name.\r
779ae357 65 @retval EFI_NOT_FOUND Routing data doesn't match any storage in this\r
66 driver.\r
67\r
68**/\r
69EFI_STATUS\r
70EFIAPI\r
71VlanExtractConfig (\r
72 IN CONST EFI_HII_CONFIG_ACCESS_PROTOCOL *This,\r
73 IN CONST EFI_STRING Request,\r
74 OUT EFI_STRING *Progress,\r
75 OUT EFI_STRING *Results\r
76 )\r
77{\r
59aefb7e
LG		 78 EFI_STATUS Status;\r
79 UINTN BufferSize;\r
80 VLAN_CONFIGURATION Configuration;\r
81 VLAN_CONFIG_PRIVATE_DATA *PrivateData;\r
82 EFI_STRING ConfigRequestHdr;\r
83 EFI_STRING ConfigRequest;\r
84 BOOLEAN AllocatedRequest;\r
85 UINTN Size;\r
86\r
87 if (Progress == NULL || Results == NULL) {\r
779ae357 88 return EFI_INVALID_PARAMETER;\r
89 }\r
90\r
59aefb7e
LG		 91 *Progress = Request;\r
92 if ((Request != NULL) && !HiiIsConfigHdrMatch (Request, &mVlanFormSetGuid, mVlanStorageName)) {\r
93 return EFI_NOT_FOUND;\r
94 }\r
95\r
96 ConfigRequestHdr = NULL;\r
97 ConfigRequest = NULL;\r
98 AllocatedRequest = FALSE;\r
99 Size = 0;\r
100\r
779ae357 101 //\r
102 // Retrieve the pointer to the UEFI HII Config Routing Protocol\r
103 //\r
104 if (mHiiConfigRouting == NULL) {\r
105 gBS->LocateProtocol (&gEfiHiiConfigRoutingProtocolGuid, NULL, (VOID **) &mHiiConfigRouting);\r
106 }\r
107 ASSERT (mHiiConfigRouting != NULL);\r
108\r
109 //\r
110 // Convert buffer data to <ConfigResp> by helper function BlockToConfig()\r
111 //\r
59aefb7e 112 PrivateData = VLAN_CONFIG_PRIVATE_DATA_FROM_THIS (This);\r
779ae357 113 ZeroMem (&Configuration, sizeof (VLAN_CONFIGURATION));\r
5a157365 114 BufferSize = sizeof (Configuration);\r
59aefb7e
LG		 115 ConfigRequest = Request;\r
116 if ((Request == NULL) || (StrStr (Request, L"OFFSET") == NULL)) {\r
117 //\r
118 // Request has no request element, construct full request string.\r
119 // Allocate and fill a buffer large enough to hold the <ConfigHdr> template\r
120 // followed by "&OFFSET=0&WIDTH=WWWWWWWWWWWWWWWW" followed by a Null-terminator\r
121 //\r
122 ConfigRequestHdr = HiiConstructConfigHdr (&mVlanFormSetGuid, mVlanStorageName, PrivateData->DriverHandle);\r
123 Size = (StrLen (ConfigRequestHdr) + 32 + 1) * sizeof (CHAR16);\r
124 ConfigRequest = AllocateZeroPool (Size);\r
125 ASSERT (ConfigRequest != NULL);\r
126 AllocatedRequest = TRUE;\r
127 UnicodeSPrint (ConfigRequest, Size, L"%s&OFFSET=0&WIDTH=%016LX", ConfigRequestHdr, (UINT64)BufferSize);\r
128 FreePool (ConfigRequestHdr);\r
129 }\r
130\r
779ae357 131 Status = mHiiConfigRouting->BlockToConfig (\r
132 mHiiConfigRouting,\r
59aefb7e 133 ConfigRequest,\r
779ae357 134 (UINT8 *) &Configuration,\r
135 BufferSize,\r
136 Results,\r
137 Progress\r
138 );\r
59aefb7e
LG		 139 //\r
140 // Free the allocated config request string.\r
141 //\r
142 if (AllocatedRequest) {\r
143 FreePool (ConfigRequest);\r
144 ConfigRequest = NULL;\r
145 }\r
146 //\r
147 // Set Progress string to the original request string.\r
148 //\r
149 if (Request == NULL) {\r
150 *Progress = NULL;\r
151 } else if (StrStr (Request, L"OFFSET") == NULL) {\r
152 *Progress = Request + StrLen (Request);\r
153 }\r
154\r
779ae357 155 return Status;\r
156}\r
157\r
158\r
159/**\r
160 This function processes the results of changes in configuration.\r
161\r
162 @param[in] This Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.\r
163 @param[in] Configuration A null-terminated Unicode string in <ConfigResp>\r
164 format.\r
165 @param[out] Progress A pointer to a string filled in with the offset of\r
166 the most recent '&' before the first failing\r
167 name/value pair (or the beginning of the string if\r
168 the failure is in the first name/value pair) or\r
169 the terminating NULL if all was successful.\r
170\r
171 @retval EFI_SUCCESS The Results is processed successfully.\r
172 @retval EFI_INVALID_PARAMETER Configuration is NULL.\r
173 @retval EFI_NOT_FOUND Routing data doesn't match any storage in this\r
174 driver.\r
175\r
176**/\r
177EFI_STATUS\r
178EFIAPI\r
179VlanRouteConfig (\r
180 IN CONST EFI_HII_CONFIG_ACCESS_PROTOCOL *This,\r
181 IN CONST EFI_STRING Configuration,\r
182 OUT EFI_STRING *Progress\r
183 )\r
184{\r
185 if (Configuration == NULL || Progress == NULL) {\r
186 return EFI_INVALID_PARAMETER;\r
187 }\r
188\r
189 *Progress = Configuration;\r
190 if (!HiiIsConfigHdrMatch (Configuration, &mVlanFormSetGuid, mVlanStorageName)) {\r
191 return EFI_NOT_FOUND;\r
192 }\r
193\r
194 *Progress = Configuration + StrLen (Configuration);\r
195 return EFI_SUCCESS;\r
196}\r
197\r
198/**\r
199 This function processes the results of changes in configuration.\r
200\r
201 @param[in] This Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.\r
202 @param[in] Action Specifies the type of action taken by the browser.\r
203 @param[in] QuestionId A unique value which is sent to the original\r
204 exporting driver so that it can identify the type\r
205 of data to expect.\r
206 @param[in] Type The type of value for the question.\r
207 @param[in] Value A pointer to the data being sent to the original\r
208 exporting driver.\r
209 @param[out] ActionRequest On return, points to the action requested by the\r
210 callback function.\r
211\r
212 @retval EFI_SUCCESS The callback successfully handled the action.\r
213 @retval EFI_OUT_OF_RESOURCES Not enough storage is available to hold the\r
214 variable and its data.\r
215 @retval EFI_DEVICE_ERROR The variable could not be saved.\r
216 @retval EFI_UNSUPPORTED The specified Action is not supported by the\r
217 callback.\r
218\r
219**/\r
220EFI_STATUS\r
221EFIAPI\r
222VlanCallback (\r
223 IN CONST EFI_HII_CONFIG_ACCESS_PROTOCOL *This,\r
224 IN EFI_BROWSER_ACTION Action,\r
225 IN EFI_QUESTION_ID QuestionId,\r
226 IN UINT8 Type,\r
227 IN EFI_IFR_TYPE_VALUE *Value,\r
228 OUT EFI_BROWSER_ACTION_REQUEST *ActionRequest\r
229 )\r
230{\r
231 VLAN_CONFIG_PRIVATE_DATA *PrivateData;\r
232 VLAN_CONFIGURATION *Configuration;\r
233 EFI_VLAN_CONFIG_PROTOCOL *VlanConfig;\r
234 UINTN Index;\r
235 EFI_HANDLE VlanHandle;\r
236\r
237 PrivateData = VLAN_CONFIG_PRIVATE_DATA_FROM_THIS (This);\r
238\r
9ea13d79 239 if ((Action == EFI_BROWSER_ACTION_FORM_OPEN) || (Action == EFI_BROWSER_ACTION_FORM_CLOSE)) {\r
779ae357 240 return EFI_SUCCESS;\r
241 }\r
242\r
083f7c69 243 if (Action == EFI_BROWSER_ACTION_CHANGING) {\r
779ae357 244 //\r
083f7c69 245 // Get Browser data\r
779ae357 246 //\r
083f7c69
ED		 247 Configuration = AllocateZeroPool (sizeof (VLAN_CONFIGURATION));\r
248 ASSERT (Configuration != NULL);\r
249 HiiGetBrowserData (&mVlanFormSetGuid, mVlanStorageName, sizeof (VLAN_CONFIGURATION), (UINT8 *) Configuration);\r
779ae357 250\r
083f7c69
ED		 251 VlanConfig = PrivateData->VlanConfig;\r
252\r
253 switch (QuestionId) {\r
254 case VLAN_ADD_QUESTION_ID:\r
779ae357 255 //\r
083f7c69 256 // Add a VLAN\r
779ae357 257 //\r
083f7c69
ED		 258 VlanConfig->Set (VlanConfig, Configuration->VlanId, Configuration->Priority);\r
259 VlanUpdateForm (PrivateData);\r
779ae357 260\r
083f7c69
ED		 261 //\r
262 // Connect the newly created VLAN device\r
263 //\r
264 VlanHandle = NetLibGetVlanHandle (PrivateData->ControllerHandle, Configuration->VlanId);\r
265 if (VlanHandle == NULL) {\r
779ae357 266 //\r
083f7c69 267 // There may be no child handle created for VLAN ID 0, connect the parent handle\r
779ae357 268 //\r
083f7c69 269 VlanHandle = PrivateData->ControllerHandle;\r
779ae357 270 }\r
083f7c69 271 gBS->ConnectController (VlanHandle, NULL, NULL, TRUE);\r
779ae357 272\r
779ae357 273 //\r
083f7c69 274 // Clear UI data\r
779ae357 275 //\r
cd3d9a85 276 *ActionRequest = EFI_BROWSER_ACTION_REQUEST_FORM_APPLY;\r
083f7c69
ED		 277 Configuration->VlanId = 0;\r
278 Configuration->Priority = 0;\r
279 break;\r
779ae357 280\r
083f7c69
ED		 281 case VLAN_REMOVE_QUESTION_ID:\r
282 //\r
283 // Remove VLAN\r
284 //\r
285 ASSERT (PrivateData->NumberOfVlan <= MAX_VLAN_NUMBER);\r
286 for (Index = 0; Index < PrivateData->NumberOfVlan; Index++) {\r
287 if (Configuration->VlanList[Index] != 0) {\r
288 //\r
289 // Checkbox is selected, need remove this VLAN\r
290 //\r
291 VlanConfig->Remove (VlanConfig, PrivateData->VlanId[Index]);\r
292 }\r
293 }\r
779ae357 294\r
083f7c69
ED		 295 VlanUpdateForm (PrivateData);\r
296 if (PrivateData->NumberOfVlan == 0) {\r
297 //\r
298 // No VLAN device now, connect the physical NIC handle.\r
299 // Note: PrivateData->NumberOfVlan has been updated by VlanUpdateForm()\r
300 //\r
301 gBS->ConnectController (PrivateData->ControllerHandle, NULL, NULL, TRUE);\r
302 }\r
303\r
cd3d9a85 304 *ActionRequest = EFI_BROWSER_ACTION_REQUEST_FORM_APPLY;\r
083f7c69
ED		 305 ZeroMem (Configuration->VlanList, MAX_VLAN_NUMBER);\r
306 break;\r
307\r
9ea13d79 308 case VLAN_UPDATE_QUESTION_ID:\r
309 //\r
310 // Update current VLAN list into Form.\r
311 //\r
312 VlanUpdateForm (PrivateData);\r
313 break;\r
314\r
083f7c69
ED		 315 default:\r
316 break;\r
317 }\r
318\r
319 HiiSetBrowserData (&mVlanFormSetGuid, mVlanStorageName, sizeof (VLAN_CONFIGURATION), (UINT8 *) Configuration, NULL);\r
320 FreePool (Configuration);\r
321 return EFI_SUCCESS;\r
779ae357 322 }\r
323\r
083f7c69
ED		 324 //\r
325 // All other action return unsupported.\r
326 //\r
327 return EFI_UNSUPPORTED;\r
779ae357 328}\r
329\r
330\r
331/**\r
332 This function update VLAN list in the VLAN configuration Form.\r
333\r
334 @param[in, out] PrivateData Points to VLAN configuration private data.\r
335\r
336**/\r
337VOID\r
338VlanUpdateForm (\r
339 IN OUT VLAN_CONFIG_PRIVATE_DATA *PrivateData\r
340 )\r
341{\r
342 EFI_VLAN_CONFIG_PROTOCOL *VlanConfig;\r
343 UINT16 NumberOfVlan;\r
344 UINTN Index;\r
345 EFI_VLAN_FIND_DATA *VlanData;\r
346 VOID *StartOpCodeHandle;\r
347 EFI_IFR_GUID_LABEL *StartLabel;\r
348 VOID *EndOpCodeHandle;\r
349 EFI_IFR_GUID_LABEL *EndLabel;\r
350 CHAR16 *String;\r
351 CHAR16 VlanStr[30];\r
352 CHAR16 VlanIdStr[6];\r
353 UINTN DigitalCount;\r
354 EFI_STRING_ID StringId;\r
355\r
356 //\r
357 // Find current VLAN configuration\r
358 //\r
359 VlanData = NULL;\r
360 NumberOfVlan = 0;\r
361 VlanConfig = PrivateData->VlanConfig;\r
362 VlanConfig->Find (VlanConfig, NULL, &NumberOfVlan, &VlanData);\r
363\r
364 //\r
365 // Update VLAN configuration in PrivateData\r
366 //\r
367 if (NumberOfVlan > MAX_VLAN_NUMBER) {\r
368 NumberOfVlan = MAX_VLAN_NUMBER;\r
369 }\r
370 PrivateData->NumberOfVlan = NumberOfVlan;\r
371\r
372 //\r
373 // Init OpCode Handle\r
374 //\r
375 StartOpCodeHandle = HiiAllocateOpCodeHandle ();\r
376 ASSERT (StartOpCodeHandle != NULL);\r
377\r
378 EndOpCodeHandle = HiiAllocateOpCodeHandle ();\r
379 ASSERT (EndOpCodeHandle != NULL);\r
380\r
381 //\r
382 // Create Hii Extend Label OpCode as the start opcode\r
383 //\r
384 StartLabel = (EFI_IFR_GUID_LABEL *) HiiCreateGuidOpCode (\r
385 StartOpCodeHandle,\r
386 &gEfiIfrTianoGuid,\r
387 NULL,\r
388 sizeof (EFI_IFR_GUID_LABEL)\r
389 );\r
390 StartLabel->ExtendOpCode = EFI_IFR_EXTEND_OP_LABEL;\r
391 StartLabel->Number = LABEL_VLAN_LIST;\r
392\r
393 //\r
394 // Create Hii Extend Label OpCode as the end opcode\r
395 //\r
396 EndLabel = (EFI_IFR_GUID_LABEL *) HiiCreateGuidOpCode (\r
397 EndOpCodeHandle,\r
398 &gEfiIfrTianoGuid,\r
399 NULL,\r
400 sizeof (EFI_IFR_GUID_LABEL)\r
401 );\r
402 EndLabel->ExtendOpCode = EFI_IFR_EXTEND_OP_LABEL;\r
403 EndLabel->Number = LABEL_END;\r
404\r
405 ZeroMem (PrivateData->VlanId, MAX_VLAN_NUMBER);\r
406 for (Index = 0; Index < NumberOfVlan; Index++) {\r
407 String = VlanStr;\r
408\r
409 StrCpy (String, L" VLAN ID:");\r
410 String += 10;\r
411 //\r
412 // Pad VlanId string up to 4 characters with space\r
413 //\r
414 DigitalCount = UnicodeValueToString (VlanIdStr, 0, VlanData[Index].VlanId, 5);\r
415 SetMem16 (String, (4 - DigitalCount) * sizeof (CHAR16), L' ');\r
416 StrCpy (String + 4 - DigitalCount, VlanIdStr);\r
417 String += 4;\r
418\r
419 StrCpy (String, L", Priority:");\r
420 String += 11;\r
421 String += UnicodeValueToString (String, 0, VlanData[Index].Priority, 4);\r
422 *String = 0;\r
423\r
424 StringId = HiiSetString (PrivateData->HiiHandle, 0, VlanStr, NULL);\r
425 ASSERT (StringId != 0);\r
426\r
427 HiiCreateCheckBoxOpCode (\r
428 StartOpCodeHandle,\r
429 (EFI_QUESTION_ID) (VLAN_LIST_VAR_OFFSET + Index),\r
430 VLAN_CONFIGURATION_VARSTORE_ID,\r
431 (UINT16) (VLAN_LIST_VAR_OFFSET + Index),\r
432 StringId,\r
433 STRING_TOKEN (STR_VLAN_VLAN_LIST_HELP),\r
434 0,\r
435 0,\r
436 NULL\r
437 );\r
438\r
439 //\r
440 // Save VLAN id to private data\r
441 //\r
442 PrivateData->VlanId[Index] = VlanData[Index].VlanId;\r
443 }\r
444\r
445 HiiUpdateForm (\r
446 PrivateData->HiiHandle, // HII handle\r
447 &mVlanFormSetGuid, // Formset GUID\r
448 VLAN_CONFIGURATION_FORM_ID, // Form ID\r
449 StartOpCodeHandle, // Label for where to insert opcodes\r
450 EndOpCodeHandle // Replace data\r
451 );\r
452\r
453 HiiFreeOpCodeHandle (StartOpCodeHandle);\r
454 HiiFreeOpCodeHandle (EndOpCodeHandle);\r
455\r
456 if (VlanData != NULL) {\r
457 FreePool (VlanData);\r
458 }\r
459}\r
460\r
461\r
462/**\r
463 This function publish the VLAN configuration Form for a network device. The\r
464 HII Config Access protocol will be installed on a child handle of the network\r
465 device.\r
466\r
467 @param[in, out] PrivateData Points to VLAN configuration private data.\r
468\r
469 @retval EFI_SUCCESS HII Form is installed for this network device.\r
470 @retval EFI_OUT_OF_RESOURCES Not enough resource for HII Form installation.\r
471 @retval Others Other errors as indicated.\r
472\r
473**/\r
474EFI_STATUS\r
475InstallVlanConfigForm (\r
476 IN OUT VLAN_CONFIG_PRIVATE_DATA *PrivateData\r
477 )\r
478{\r
479 EFI_STATUS Status;\r
480 EFI_HII_HANDLE HiiHandle;\r
481 EFI_HANDLE DriverHandle;\r
e2851998 482 CHAR16 Str[26 + sizeof (EFI_MAC_ADDRESS) * 2 + 1];\r
779ae357 483 CHAR16 *MacString;\r
484 EFI_DEVICE_PATH_PROTOCOL *ChildDevicePath;\r
485 EFI_HII_CONFIG_ACCESS_PROTOCOL *ConfigAccess;\r
486\r
487 //\r
488 // Create child handle and install HII Config Access Protocol\r
489 //\r
490 ChildDevicePath = AppendDevicePathNode (\r
491 PrivateData->ParentDevicePath,\r
492 (CONST EFI_DEVICE_PATH_PROTOCOL *) &mHiiVendorDevicePathNode\r
493 );\r
494 if (ChildDevicePath == NULL) {\r
495 return EFI_OUT_OF_RESOURCES;\r
496 }\r
497 PrivateData->ChildDevicePath = ChildDevicePath;\r
498\r
499 DriverHandle = NULL;\r
500 ConfigAccess = &PrivateData->ConfigAccess;\r
501 Status = gBS->InstallMultipleProtocolInterfaces (\r
502 &DriverHandle,\r
503 &gEfiDevicePathProtocolGuid,\r
504 ChildDevicePath,\r
505 &gEfiHiiConfigAccessProtocolGuid,\r
506 ConfigAccess,\r
507 NULL\r
508 );\r
509 if (EFI_ERROR (Status)) {\r
510 return Status;\r
511 }\r
512 PrivateData->DriverHandle = DriverHandle;\r
513\r
514 //\r
515 // Publish the HII package list\r
516 //\r
517 HiiHandle = HiiAddPackages (\r
518 &mVlanFormSetGuid,\r
519 DriverHandle,\r
520 VlanConfigDxeStrings,\r
521 VlanConfigBin,\r
522 NULL\r
523 );\r
524 if (HiiHandle == NULL) {\r
525 return EFI_OUT_OF_RESOURCES;\r
526 }\r
527 PrivateData->HiiHandle = HiiHandle;\r
528\r
529 //\r
3ddc4cf2 530 // Update formset title help string.\r
779ae357 531 //\r
532 MacString = NULL;\r
533 Status = NetLibGetMacString (PrivateData->ControllerHandle, PrivateData->ImageHandle, &MacString);\r
534 if (EFI_ERROR (Status)) {\r
535 return Status;\r
536 }\r
537 PrivateData->MacString = MacString;\r
538\r
539 StrCpy (Str, L"VLAN Configuration (MAC:");\r
1b2bf3ca 540 StrnCat (Str, MacString, sizeof (EFI_MAC_ADDRESS) * 2);\r
779ae357 541 StrCat (Str, L")");\r
542 HiiSetString (\r
543 HiiHandle,\r
c7f204db 544 STRING_TOKEN (STR_VLAN_FORM_SET_TITLE_HELP),\r
779ae357 545 Str,\r
546 NULL\r
547 );\r
548\r
549 //\r
3ddc4cf2 550 // Update form title help string.\r
779ae357 551 //\r
552 HiiSetString (\r
553 HiiHandle,\r
c7f204db 554 STRING_TOKEN (STR_VLAN_FORM_HELP),\r
779ae357 555 Str,\r
556 NULL\r
557 );\r
558\r
559 return EFI_SUCCESS;\r
560}\r
561\r
562/**\r
563 This function remove the VLAN configuration Form for a network device. The\r
564 child handle for HII Config Access protocol will be destroyed.\r
565\r
566 @param[in, out] PrivateData Points to VLAN configuration private data.\r
567\r
568**/\r
569VOID\r
570UninstallVlanConfigForm (\r
571 IN OUT VLAN_CONFIG_PRIVATE_DATA *PrivateData\r
572 )\r
573{\r
574 //\r
575 // Free MAC string\r
576 //\r
577 if (PrivateData->MacString != NULL) {\r
578 FreePool (PrivateData->MacString);\r
579 PrivateData->MacString = NULL;\r
580 }\r
581\r
582 //\r
583 // Uninstall HII package list\r
584 //\r
585 if (PrivateData->HiiHandle != NULL) {\r
586 HiiRemovePackages (PrivateData->HiiHandle);\r
587 PrivateData->HiiHandle = NULL;\r
588 }\r
589\r
590 //\r
591 // Uninstall HII Config Access Protocol\r
592 //\r
593 if (PrivateData->DriverHandle != NULL) {\r
594 gBS->UninstallMultipleProtocolInterfaces (\r
595 PrivateData->DriverHandle,\r
596 &gEfiDevicePathProtocolGuid,\r
597 PrivateData->ChildDevicePath,\r
598 &gEfiHiiConfigAccessProtocolGuid,\r
599 &PrivateData->ConfigAccess,\r
600 NULL\r
601 );\r
602 PrivateData->DriverHandle = NULL;\r
603\r
604 if (PrivateData->ChildDevicePath != NULL) {\r
605 FreePool (PrivateData->ChildDevicePath);\r
606 PrivateData->ChildDevicePath = NULL;\r
607 }\r
608 }\r
609}\r
EFI Development Kit II mirror for PVE