Refine function comments for BdsDxe module.

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@7093 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
klu2 2008-12-23 03:32:20 +00:00
parent dddb694d3e
commit 2e9f9668a9
3 changed files with 100 additions and 227 deletions

View File

@ -1,5 +1,5 @@
/** @file
Boot Maintainence Main File
The functions for Boot Maintainence Main menu.
Copyright (c) 2004 - 2008, Intel Corporation. <BR>
All rights reserved. This program and the accompanying materials
@ -59,14 +59,12 @@ FreeAllMenu (
/**
Create string tokens for a menu from its help strings and display strings
@param CallbackData The BMM context data.
@param HiiHandle Hii Handle of the package to be updated.
@param MenuOption The Menu whose string tokens need to be created
@retval EFI_SUCCESS string tokens created successfully
@retval EFI_SUCCESS String tokens created successfully
@retval others contain some errors
**/
EFI_STATUS
CreateMenuStringToken (
@ -137,7 +135,7 @@ BootMaintExtractConfig (
BMM_CALLBACK_DATA *Private;
if (Request == NULL) {
return EFI_NOT_FOUND;
return EFI_INVALID_PARAMETER;
}
Private = BMM_CALLBACK_DATA_FROM_THIS (This);
@ -161,19 +159,19 @@ BootMaintExtractConfig (
This function processes the results of changes in configuration.
@param This - Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.
@param Action - Specifies the type of action taken by the browser.
@param QuestionId - A unique value which is sent to the original exporting driver
@param This Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.
@param Action Specifies the type of action taken by the browser.
@param QuestionId A unique value which is sent to the original exporting driver
so that it can identify the type of data to expect.
@param Type - The type of value for the question.
@param Value - A pointer to the data being sent to the original exporting driver.
@param ActionRequest - On return, points to the action requested by the callback function.
@param Type The type of value for the question.
@param Value A pointer to the data being sent to the original exporting driver.
@param ActionRequest On return, points to the action requested by the callback function.
@retval EFI_SUCCESS The callback successfully handled the action.
@retval EFI_OUT_OF_RESOURCES Not enough storage is available to hold the variable and its data.
@retval EFI_DEVICE_ERROR The variable could not be saved.
@retval EFI_UNSUPPORTED The specified Action is not supported by the callback.
@retval EFI_INVALID_PARAMETER The parameter of Value or ActionRequest is invalid.
**/
EFI_STATUS
EFIAPI
@ -1206,9 +1204,6 @@ CleanUpStringDepository (
/**
Start boot maintenance manager
@retval EFI_SUCCESS If BMM is invoked successfully.
@return Other value if BMM return unsuccessfully.
@ -1317,7 +1312,7 @@ FormSetDispatcher (
Deletete the Boot Option from EFI Variable. The Boot Order Arrray
is also updated.
@param OptionNumber EDES_TODO: Add parameter description
@param OptionNumber The number of Boot option want to be deleted.
@param BootOrder The Boot Order array.
@param BootOrderSize The size of the Boot Order Array.
@ -1342,6 +1337,7 @@ BdsDeleteBootOption (
UnicodeSPrint (BootOption, sizeof (BootOption), L"Boot%04x", OptionNumber);
Status = EfiLibDeleteVariable (BootOption, &gEfiGlobalVariableGuid);
//
// adjust boot order array
//

View File

@ -27,10 +27,10 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
#define VAR_CON_OUT_MODE L"ConOutMode"
//
// Guid of a NV Variable which store the information about the
// FD/HD/CD/NET/BEV order
//
///
/// Guid of a NV Variable which store the information about the
/// FD/HD/CD/NET/BEV order
///
#define EFI_LEGACY_DEV_ORDER_VARIABLE_GUID \
{ \
0xa56074db, 0x65fe, 0x45f7, {0xbd, 0x21, 0x2d, 0x2b, 0xdd, 0x8e, 0x96, 0x52} \
@ -291,9 +291,9 @@ typedef struct {
#pragma pack(1)
typedef struct {
BBS_TYPE BbsType;
//
// Length = sizeof (UINT16) + SIZEOF (Data)
//
///
/// Length = sizeof (UINT16) + SIZEOF (Data)
///
UINT16 Length;
UINT16 *Data;
} BM_LEGACY_DEV_ORDER_CONTEXT;
@ -538,8 +538,6 @@ BOpt_GetDriverOptions (
/**
Build the LegacyFDMenu LegacyHDMenu LegacyCDMenu according to LegacyBios.GetBbsInfo().
@retval EFI_SUCCESS The function complete successfully.
@retval EFI_OUT_OF_RESOURCES No enough memory to complete this function.
@ -552,10 +550,6 @@ BOpt_GetLegacyOptions (
/**
Free out resouce allocated from Legacy Boot Options.
.
.
**/
VOID
BOpt_FreeLegacyOptions (
@ -567,8 +561,6 @@ BOpt_FreeLegacyOptions (
@param FreeMenu Menu to be freed
**/
VOID
BOpt_FreeMenu (
@ -700,7 +692,6 @@ BOpt_GetMenuEntry (
/**
Build a list containing all serial devices.
@retval EFI_SUCCESS The function complete successfully.
@retval EFI_UNSUPPORTED No serial ports present.
@ -716,9 +707,6 @@ LocateSerialIo (
/**
Build up ConsoleOutMenu, ConsoleInpMenu and ConsoleErrMenu
@retval EFI_SUCCESS The function always complete successfully.
**/
@ -733,11 +721,7 @@ GetAllConsoles(
/**
Get mode number according to column and row
@param CallbackData The BMM context data.
**/
VOID
GetConsoleOutMode (
@ -750,9 +734,6 @@ GetConsoleOutMode (
/**
Free ConsoleOutMenu, ConsoleInpMenu and ConsoleErrMenu
EDES_TODO: Add parameter description
@retval EFI_SUCCESS The function always complete successfully.
**/
EFI_STATUS
@ -765,9 +746,7 @@ FreeAllConsoles (
based on the new BaudRate, Data Bits, parity and Stop Bits
set.
@param DevicePath
@param DevicePath The devicepath protocol instance wanted to be updated.
**/
VOID
@ -792,6 +771,7 @@ ChangeTerminalDevicePath (
IN OUT EFI_DEVICE_PATH_PROTOCOL *DevicePath,
IN BOOLEAN ChangeTerminal
);
//
// Variable operation by menu selection
//
@ -819,9 +799,6 @@ Var_UpdateBootOption (
After deleting this boot option, call Var_ChangeBootOrder to
make sure BootOrder is in valid state.
EDES_TODO: Add parameter description
@retval EFI_SUCCESS If all boot load option EFI Variables corresponding to
BM_LOAD_CONTEXT marked for deletion is deleted
@return Others If failed to update the "BootOrder" variable after deletion.
@ -838,12 +815,8 @@ Var_DelBootOption (
not reflected by BootOrder. Then a function rebuild BootOrder from
scratch by content from BootOptionMenu is needed.
@retval EFI_SUCCESS The boot order is updated successfully.
@return EFI_STATUS other than EFI_SUCCESS if failed to
Set the "BootOrder" EFI Variable.
@return other than EFI_SUCCESS if failed to change the "BootOrder" EFI Variable.
**/
EFI_STATUS
@ -861,7 +834,7 @@ Var_ChangeBootOrder (
@param HiiHandle The HII handle associated with the BMM formset.
@param DescriptionData The description of this driver option.
@param OptionalData The optional load option.
@param ForceReconnect EDES_TODO: Add parameter description
@param ForceReconnect If to force reconnect.
@retval EFI_OUT_OF_RESOURCES If not enought memory to complete the operation.
@retval EFI_SUCCESS If function completes successfully.
@ -881,9 +854,6 @@ Var_UpdateDriverOption (
After deleting this Driver option, call Var_ChangeDriverOrder to
make sure DriverOrder is in valid state.
@retval EFI_SUCCESS Load Option is successfully updated.
@return Other value than EFI_SUCCESS if failed to update "Driver Order" EFI
Variable.
@ -901,12 +871,8 @@ Var_DelDriverOption (
rebuild DriverOrder from scratch by content from DriverOptionMenu is
needed.
@retval EFI_SUCCESS The driver order is updated successfully.
@return EFI_STATUS other than EFI_SUCCESS if failed to
Set the "DriverOrder" EFI Variable.
@return other than EFI_SUCCESS if failed to set the "DriverOrder" EFI Variable.
**/
EFI_STATUS
@ -918,12 +884,8 @@ Var_ChangeDriverOrder (
This function delete and build multi-instance device path ConIn
console device.
@retval EFI_SUCCESS The function complete successfully.
@return The EFI variable can be saved. See gRT->SetVariable
for detail return information.
@return The EFI variable can not be saved. See gRT->SetVariable for detail return information.
**/
EFI_STATUS
Var_UpdateConsoleInpOption (
@ -931,15 +893,10 @@ Var_UpdateConsoleInpOption (
);
/**
This function delete and build multi-instance device path ConOut
console device.
This function delete and build multi-instance device path ConOut console device.
@retval EFI_SUCCESS The function complete successfully.
@return The EFI variable can be saved. See gRT->SetVariable
for detail return information.
@return The EFI variable can not be saved. See gRT->SetVariable for detail return information.
**/
EFI_STATUS
Var_UpdateConsoleOutOption (
@ -947,15 +904,10 @@ Var_UpdateConsoleOutOption (
);
/**
This function delete and build multi-instance device path ErrOut
console device.
This function delete and build multi-instance device path ErrOut console device.
@retval EFI_SUCCESS The function complete successfully.
@return The EFI variable can be saved. See gRT->SetVariable
for detail return information.
@return The EFI variable can not be saved. See gRT->SetVariable for detail return information.
**/
EFI_STATUS
Var_UpdateErrorOutOption (
@ -963,13 +915,8 @@ Var_UpdateErrorOutOption (
);
/**
Update the device path of "ConOut", "ConIn" and "ErrOut"
based on the new BaudRate, Data Bits, parity and Stop Bits
set.
Update the device path of "ConOut", "ConIn" and "ErrOut" based on the new BaudRate, Data Bits,
parity and stop Bits set.
**/
VOID
@ -978,16 +925,14 @@ Var_UpdateAllConsoleOption (
);
/**
This function update the "BootNext" EFI Variable. If there is
no "BootNex" specified in BMM, this EFI Variable is deleted.
It also update the BMM context data specified the "BootNext"
vaule.
This function update the "BootNext" EFI Variable. If there is no "BootNex" specified in BMM,
this EFI Variable is deleted.
It also update the BMM context data specified the "BootNext" value.
@param CallbackData The BMM context data.
@retval EFI_SUCCESS The function complete successfully.
@return The EFI variable can be saved. See gRT->SetVariable
for detail return information.
@return The EFI variable can not be saved. See gRT->SetVariable for detail return information.
**/
EFI_STATUS
@ -996,16 +941,14 @@ Var_UpdateBootNext (
);
/**
This function update the "BootOrder" EFI Variable based on
BMM Formset's NV map. It then refresh BootOptionMenu
with the new "BootOrder" list.
This function update the "BootOrder" EFI Variable based on BMM Formset's NV map. It then refresh
BootOptionMenu with the new "BootOrder" list.
@param CallbackData The BMM context data.
@retval EFI_SUCCESS The function complete successfully.
@retval EFI_SUCCESS Not enough memory to complete the function.
@return The EFI variable can be saved. See gRT->SetVariable
for detail return information.
@retval EFI_OUT_OF_RESOURCES Not enough memory to complete the function.
@return not The EFI variable can not be saved. See gRT->SetVariable for detail return information.
**/
EFI_STATUS
@ -1021,9 +964,8 @@ Var_UpdateBootOrder (
@param CallbackData The BMM context data.
@retval EFI_SUCCESS The function complete successfully.
@retval EFI_SUCCESS Not enough memory to complete the function.
@return The EFI variable can be saved. See gRT->SetVariable
for detail return information.
@retval EFI_OUT_OF_RESOURCES Not enough memory to complete the function.
@return The EFI variable can not be saved. See gRT->SetVariable for detail return information.
**/
EFI_STATUS
@ -1039,7 +981,7 @@ Var_UpdateDriverOrder (
@param CallbackData The context data for BMM.
@return EFI_SUCCESS The function completed successfully.
@retval EFI_NOT_FOUND If L"LegacyDevOrder" and EfiLegacyDevOrderGuid EFI Variable can be found.
@retval EFI_NOT_FOUND If L"LegacyDevOrder" and EfiLegacyDevOrderGuid EFI Variable can not be found.
**/
EFI_STATUS
@ -1067,10 +1009,6 @@ Var_UpdateConMode (
/**
Refresh the global UpdateData structure.
**/
VOID
RefreshUpdateData (
@ -1085,8 +1023,6 @@ RefreshUpdateData (
opcode deletion.
@param CallbackData The BMM context data.
**/
VOID
CleanUpPage (
@ -1100,8 +1036,6 @@ CleanUpPage (
@param CallbackData The BMM context data.
**/
VOID
UpdateBootDelPage (
@ -1112,9 +1046,6 @@ UpdateBootDelPage (
Create a lit of driver option from global DriverMenu.
@param CallbackData The BMM context data.
**/
VOID
UpdateDrvAddHandlePage (
@ -1125,11 +1056,7 @@ UpdateDrvAddHandlePage (
Create a lit of driver option from global DriverOptionMenu. It
allow user to delete the driver option.
@param CallbackData The BMM context data.
**/
VOID
UpdateDrvDelPage (
@ -1137,13 +1064,9 @@ UpdateDrvDelPage (
);
/**
Prepare the page to allow user to add description for
a Driver Option.
Prepare the page to allow user to add description for a Driver Option.
@param CallbackData The BMM context data.
**/
VOID
UpdateDriverAddHandleDescPage (
@ -1151,14 +1074,10 @@ UpdateDriverAddHandleDescPage (
);
/**
Dispatch the correct update page function to call based on
the UpdatePageId.
Dispatch the correct update page function to call based on the UpdatePageId.
@param UpdatePageId The form ID.
@param CallbackData The BMM context data.
**/
VOID
UpdatePageBody (
@ -1167,13 +1086,9 @@ UpdatePageBody (
);
/**
Create the dynamic page to allow user to set
the "BootNext" vaule.
Create the dynamic page to allow user to set the "BootNext" vaule.
@param CallbackData The BMM context data.
**/
VOID
UpdateBootNextPage (
@ -1181,13 +1096,9 @@ UpdateBootNextPage (
);
/**
Create the dynamic page to allow user to set
the "TimeOut" vaule.
Create the dynamic page to allow user to set the "TimeOut" vaule.
@param CallbackData The BMM context data.
**/
VOID
UpdateTimeOutPage (
@ -1195,14 +1106,10 @@ UpdateTimeOutPage (
);
/**
Create the dynamic page which allows user to
set the property such as Baud Rate, Data Bits,
Create the dynamic page which allows user to set the property such as Baud Rate, Data Bits,
Parity, Stop Bits, Terminal Type.
@param CallbackData The BMM context data.
**/
VOID
UpdateTerminalPage (
@ -1212,11 +1119,7 @@ UpdateTerminalPage (
/**
Refresh the text mode page
@param CallbackData The BMM context data.
**/
VOID
UpdateConModePage (
@ -1228,9 +1131,6 @@ UpdateConModePage (
by TerminaMenu. This list will be inserted to form FORM_CON_COM_SETUP_ID.
@param CallbackData The BMM context data.
**/
VOID
UpdateConCOMPage (
@ -1243,9 +1143,6 @@ UpdateConCOMPage (
@param UpdatePageId The form ID. It also spefies the legacy device type.
@param CallbackData The BMM context data.
**/
VOID
UpdateSetLegacyDeviceOrderPage (
@ -1255,14 +1152,10 @@ UpdateSetLegacyDeviceOrderPage (
/**
Function opens and returns a file handle to the root directory of a volume.
@param DeviceHandle - A handle for a device
@param DeviceHandle A handle for a device
@return A valid file handle or NULL is returned
**/
EFI_FILE_HANDLE
EfiLibOpenRoot (
@ -1270,16 +1163,13 @@ EfiLibOpenRoot (
);
/**
Function gets the file system information from an open file descriptor,
and stores it in a buffer allocated from pool.
@param FHand The file handle.
@return A pointer to a buffer with file information.
@retval NULL is returned if failed to get Vaolume Label Info.
NULL is returned if failed to get Vaolume Label Info.
**/
EFI_FILE_SYSTEM_VOLUME_LABEL *
EfiLibFileSystemVolumeLabelInfo (
@ -1315,10 +1205,7 @@ DevicePathToStr (
);
/**
Find the first instance of this Protocol
in the system and return it's interface.
Find the first instance of this Protocol in the system and return it's interface.
@param ProtocolGuid Provides the protocol to search for
@param Interface On return, a pointer to the first interface
@ -1337,13 +1224,11 @@ EfiLibLocateProtocol (
/**
Adjusts the size of a previously allocated buffer.
@param OldPool A pointer to the buffer whose size is being adjusted.
@param OldSize The size of the current buffer.
@param NewSize The size of the new buffer.
@param OldPool - A pointer to the buffer whose size is being adjusted.
@param OldSize - The size of the current buffer.
@param NewSize - The size of the new buffer.
@return The newly allocated buffer.
@retval NULL Allocation failed.
@return The newly allocated buffer. if NULL, allocation failed.
**/
VOID*
@ -1377,10 +1262,10 @@ BdsLibGetVariableAndSize (
Function deletes the variable specified by VarName and VarGuid.
@param VarName - A Null-terminated Unicode string that is
@param VarName A Null-terminated Unicode string that is
the name of the vendor's variable.
@param VarGuid - A unique identifier for the vendor.
@param VarGuid A unique identifier for the vendor.
@retval EFI_SUCCESS The variable was found and removed
@retval EFI_UNSUPPORTED The variable store was inaccessible
@ -1468,8 +1353,6 @@ EfiLibStrFromDatahub (
@param OptionIndex Returns the index number (#### in Boot####).
@param OptionSize Return the size of the Boot### variable.
**/
VOID *
GetLegacyBootOptionVar (
@ -1493,9 +1376,6 @@ InitializeBM (
/**
Start boot maintenance manager
@retval EFI_SUCCESS If BMM is invoked successfully.
@return Other value if BMM return unsuccessfully.
@ -1518,8 +1398,8 @@ InitializeStringDepository (
Fetch a usable string node from the string depository and return the string token.
@param CallbackData EDES_TODO: Add parameter description
@param StringDepository - Pointer of the string depository.
@param CallbackData The BMM context data.
@param StringDepository Pointer of the string depository.
@retval EFI_STRING_ID String token.
@ -1550,10 +1430,9 @@ CleanUpStringDepository (
/**
Function handling request to apply changes for BMM pages.
@param Private - Pointer to callback data buffer.
@param CurrentFakeNVMap - Pointer to buffer holding data of various values used by BMM
@param FormId - ID of the form which has sent the request to apply change.
@param Private Pointer to callback data buffer.
@param CurrentFakeNVMap Pointer to buffer holding data of various values used by BMM
@param FormId ID of the form which has sent the request to apply change.
@retval EFI_SUCCESS Change successfully applied.
@retval Other Error occurs while trying to apply changes.

View File

@ -384,8 +384,7 @@ Var_UpdateAllConsoleOption (
to be processed.
@retval EFI_SUCCESS The function complete successfully.
@return The EFI variable can be saved. See gRT->SetVariable
for detail return information.
@return The EFI variable can not be saved. See gRT->SetVariable for detail return information.
**/
EFI_STATUS
@ -938,9 +937,8 @@ Var_UpdateBootNext (
@param CallbackData The BMM context data.
@retval EFI_SUCCESS The function complete successfully.
@retval EFI_SUCCESS Not enough memory to complete the function.
@return The EFI variable can be saved. See gRT->SetVariable
for detail return information.
@retval EFI_OUT_OF_RESOURCES Not enough memory to complete the function.
@return The EFI variable can not be saved. See gRT->SetVariable for detail return information.
**/
EFI_STATUS