Add doxygen style comments for functions in DxeMain.
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@5189 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
@@ -17,7 +17,28 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
|
||||
#define WATCHDOG_TIMER_CALIBRATE_PER_SECOND 10000000
|
||||
|
||||
/**
|
||||
Sets the system's watchdog timer.
|
||||
|
||||
@param Timeout The number of seconds to set the watchdog timer to.
|
||||
A value of zero disables the timer.
|
||||
@param WatchdogCode The numeric code to log on a watchdog timer timeout
|
||||
event. The firmware reserves codes 0x0000 to 0xFFFF.
|
||||
Loaders and operating systems may use other timeout
|
||||
codes.
|
||||
@param DataSize The size, in bytes, of WatchdogData.
|
||||
@param WatchdogData A data buffer that includes a Null-terminated Unicode
|
||||
string, optionally followed by additional binary data.
|
||||
The string is a description that the call may use to
|
||||
further indicate the reason to be logged with a
|
||||
watchdog event.
|
||||
|
||||
@return EFI_SUCCESS Timeout has been set
|
||||
@return EFI_NOT_AVAILABLE_YET WatchdogTimer is not available yet
|
||||
@return EFI_UNSUPPORTED System does not have a timer (currently not used)
|
||||
@return EFI_DEVICE_ERROR Could not complete due to hardware error
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
CoreSetWatchdogTimer (
|
||||
@@ -26,31 +47,6 @@ CoreSetWatchdogTimer (
|
||||
IN UINTN DataSize,
|
||||
IN CHAR16 *WatchdogData OPTIONAL
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description:
|
||||
|
||||
Sets the system's watchdog timer.
|
||||
|
||||
Arguments:
|
||||
|
||||
Timeout The number of seconds. Zero disables the timer.
|
||||
|
||||
///////following three parameters are left for platform specific using
|
||||
|
||||
WatchdogCode The numberic code to log. 0x0 to 0xffff are firmware
|
||||
DataSize Size of the optional data
|
||||
WatchdogData Optional Null terminated unicode string followed by binary
|
||||
data.
|
||||
|
||||
Returns:
|
||||
|
||||
EFI_SUCCESS Timeout has been set
|
||||
EFI_NOT_AVAILABLE_YET WatchdogTimer is not available yet
|
||||
EFI_UNSUPPORTED System does not have a timer (currently not used)
|
||||
EFI_DEVICE_ERROR Could not complete due to hardware error
|
||||
|
||||
--*/
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
|
||||
|
Reference in New Issue
Block a user