- Set current time and date information.\r
-\r
- @param Time A pointer to cache of time setting.\r
-\r
- @retval EFI_SUCCESS Success to execute the function.\r
- @retval !EFI_SUCCESS Failed to execute the function.\r
+ This service is a wrapper for the UEFI Runtime Service SetTime().\r
+\r
+ The SetTime() function sets the real time clock device to the supplied time, and records the\r
+ current time zone and daylight savings time information. The SetTime() function is not allowed\r
+ to loop based on the current time. For example, if the device does not support a hardware reset\r
+ for the sub-resolution time, the code is not to implement the feature by waiting for the time to\r
+ wrap.\r
+ During runtime, if a PC-AT CMOS device is present in the platform the caller must synchronize\r
+ access to the device before calling SetTime().\r
+\r
+ @param Time A pointer to the current time. Type EFI_TIME is defined in the GetTime()\r
+ function description. Full error checking is performed on the different\r
+ fields of the EFI_TIME structure (refer to the EFI_TIME definition in the\r
+ GetTime() function description for full details), and EFI_INVALID_PARAMETER\r
+ is returned if any field is out of range.\r
+\r
+ @retval EFI_SUCCESS The operation completed successfully.\r
+ @retval EFI_INVALID_PARAMETER A time field is out of range.\r
+ @retval EFI_DEVICE_ERROR The time could not be set due to a hardware error.\r