]> git.proxmox.com Git - mirror_edk2.git/blobdiff - MdeModulePkg/Core/Dxe/Event/Timer.c
MdeModulePkg/Core: Fix typos in comments
[mirror_edk2.git] / MdeModulePkg / Core / Dxe / Event / Timer.c
index 924499e004f369514c966630d6b73a0d874f2356..6cd4e6c1854bbbbf71c1cf6645ff797027f79644 100644 (file)
@@ -1,8 +1,8 @@
 /** @file\r
   Core Timer Services\r
 \r
-Copyright (c) 2006 - 2008, Intel Corporation. <BR>\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2006 - 2013, Intel Corporation. All rights reserved.<BR>\r
+This program and the accompanying materials\r
 are licensed and made available under the terms and conditions of the BSD License\r
 which accompanies this distribution.  The full text of the license may be found at\r
 http://opensource.org/licenses/bsd-license.php\r
@@ -13,48 +13,8 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 **/\r
 \r
 \r
-#include <DxeMain.h>\r
-\r
-//\r
-// Internal prototypes\r
-//\r
-/**\r
-  Returns the current system time.\r
-\r
-  @return The current system time\r
-\r
-**/\r
-UINT64\r
-CoreCurrentSystemTime (\r
-  VOID\r
-  );\r
-\r
-/**\r
-  Checks the sorted timer list against the current system time.\r
-  Signals any expired event timer.\r
-\r
-  @param  CheckEvent             Not used \r
-  @param  Context                Not used\r
-\r
-**/\r
-VOID\r
-EFIAPI\r
-CoreCheckTimers (\r
-  IN EFI_EVENT            CheckEvent,\r
-  IN VOID                 *Context\r
-  );\r
-\r
-/**\r
-  Inserts the timer event.\r
-\r
-  @param  Event                  Points to the internal structure of timer event \r
-                                 to be installed\r
-\r
-**/\r
-VOID\r
-CoreInsertEventTimer (\r
-  IN IEVENT   *Event\r
-  );\r
+#include "DxeMain.h"\r
+#include "Event.h"\r
 \r
 //\r
 // Internal data\r
@@ -71,26 +31,41 @@ UINT64           mEfiSystemTime = 0;
 // Timer functions\r
 //\r
 /**\r
-  Initializes timer support.\r
+  Inserts the timer event.\r
+\r
+  @param  Event                  Points to the internal structure of timer event\r
+                                 to be installed\r
 \r
 **/\r
 VOID\r
-CoreInitializeTimer (\r
-  VOID\r
+CoreInsertEventTimer (\r
+  IN IEVENT   *Event\r
   )\r
 {\r
-  EFI_STATUS  Status;\r
+  UINT64          TriggerTime;\r
+  LIST_ENTRY      *Link;\r
+  IEVENT          *Event2;\r
 \r
-  Status = CoreCreateEvent (\r
-             EVT_NOTIFY_SIGNAL,\r
-             TPL_HIGH_LEVEL - 1,\r
-             CoreCheckTimers,\r
-             NULL,\r
-             &mEfiCheckTimerEvent\r
-             );\r
-  ASSERT_EFI_ERROR (Status);\r
-}\r
+  ASSERT_LOCKED (&mEfiTimerLock);\r
+\r
+  //\r
+  // Get the timer's trigger time\r
+  //\r
+  TriggerTime = Event->Timer.TriggerTime;\r
 \r
+  //\r
+  // Insert the timer into the timer database in assending sorted order\r
+  //\r
+  for (Link = mEfiTimerList.ForwardLink; Link != &mEfiTimerList; Link = Link->ForwardLink) {\r
+    Event2 = CR (Link, IEVENT, Timer.Link, EVENT_SIGNATURE);\r
+\r
+    if (Event2->Timer.TriggerTime > TriggerTime) {\r
+      break;\r
+    }\r
+  }\r
+\r
+  InsertTailList (Link, &Event->Timer.Link);\r
+}\r
 \r
 /**\r
   Returns the current system time.\r
@@ -108,57 +83,15 @@ CoreCurrentSystemTime (
   CoreAcquireLock (&mEfiSystemTimeLock);\r
   SystemTime = mEfiSystemTime;\r
   CoreReleaseLock (&mEfiSystemTimeLock);\r
-  \r
-  return SystemTime;\r
-}\r
-\r
-\r
-/**\r
-  Called by the platform code to process a tick.\r
-\r
-  @param  Duration               The number of 100ns elasped since the last call \r
-                                 to TimerTick\r
-\r
-**/\r
-VOID\r
-EFIAPI\r
-CoreTimerTick (\r
-  IN UINT64   Duration\r
-  )\r
-{\r
-  IEVENT          *Event;\r
-\r
-  //\r
-  // Check runtiem flag in case there are ticks while exiting boot services\r
-  //\r
-  CoreAcquireLock (&mEfiSystemTimeLock);\r
-\r
-  //\r
-  // Update the system time\r
-  //\r
-  mEfiSystemTime += Duration;\r
-\r
-  //\r
-  // If the head of the list is expired, fire the timer event\r
-  // to process it\r
-  //\r
-  if (!IsListEmpty (&mEfiTimerList)) {\r
-    Event = CR (mEfiTimerList.ForwardLink, IEVENT, u.Timer.Link, EVENT_SIGNATURE);\r
-\r
-    if (Event->u.Timer.TriggerTime <= mEfiSystemTime) {\r
-      CoreSignalEvent (mEfiCheckTimerEvent);\r
-    }\r
-  }\r
 \r
-  CoreReleaseLock (&mEfiSystemTimeLock);\r
+  return SystemTime;\r
 }\r
 \r
-\r
 /**\r
   Checks the sorted timer list against the current system time.\r
   Signals any expired event timer.\r
 \r
-  @param  CheckEvent             Not used \r
+  @param  CheckEvent             Not used\r
   @param  Context                Not used\r
 \r
 **/\r
@@ -179,12 +112,12 @@ CoreCheckTimers (
   SystemTime = CoreCurrentSystemTime ();\r
 \r
   while (!IsListEmpty (&mEfiTimerList)) {\r
-    Event = CR (mEfiTimerList.ForwardLink, IEVENT, u.Timer.Link, EVENT_SIGNATURE);\r
+    Event = CR (mEfiTimerList.ForwardLink, IEVENT, Timer.Link, EVENT_SIGNATURE);\r
 \r
     //\r
     // If this timer is not expired, then we're done\r
     //\r
-    if (Event->u.Timer.TriggerTime > SystemTime) {\r
+    if (Event->Timer.TriggerTime > SystemTime) {\r
       break;\r
     }\r
 \r
@@ -192,8 +125,8 @@ CoreCheckTimers (
     // Remove this timer from the timer queue\r
     //\r
 \r
-    RemoveEntryList (&Event->u.Timer.Link);\r
-    Event->u.Timer.Link.ForwardLink = NULL;\r
+    RemoveEntryList (&Event->Timer.Link);\r
+    Event->Timer.Link.ForwardLink = NULL;\r
 \r
     //\r
     // Signal it\r
@@ -203,17 +136,17 @@ CoreCheckTimers (
     //\r
     // If this is a periodic timer, set it\r
     //\r
-    if (Event->u.Timer.Period) {\r
+    if (Event->Timer.Period != 0) {\r
       //\r
       // Compute the timers new trigger time\r
       //\r
-      Event->u.Timer.TriggerTime = Event->u.Timer.TriggerTime + Event->u.Timer.Period;\r
+      Event->Timer.TriggerTime = Event->Timer.TriggerTime + Event->Timer.Period;\r
 \r
       //\r
       // If that's before now, then reset the timer to start from now\r
       //\r
-      if (Event->u.Timer.TriggerTime <= SystemTime) {\r
-        Event->u.Timer.TriggerTime = SystemTime;\r
+      if (Event->Timer.TriggerTime <= SystemTime) {\r
+        Event->Timer.TriggerTime = SystemTime;\r
         CoreSignalEvent (mEfiCheckTimerEvent);\r
       }\r
 \r
@@ -229,40 +162,66 @@ CoreCheckTimers (
 \r
 \r
 /**\r
-  Inserts the timer event.\r
+  Initializes timer support.\r
+\r
+**/\r
+VOID\r
+CoreInitializeTimer (\r
+  VOID\r
+  )\r
+{\r
+  EFI_STATUS  Status;\r
+\r
+  Status = CoreCreateEventInternal (\r
+             EVT_NOTIFY_SIGNAL,\r
+             TPL_HIGH_LEVEL - 1,\r
+             CoreCheckTimers,\r
+             NULL,\r
+             NULL,\r
+             &mEfiCheckTimerEvent\r
+             );\r
+  ASSERT_EFI_ERROR (Status);\r
+}\r
 \r
-  @param  Event                  Points to the internal structure of timer event \r
-                                 to be installed\r
+\r
+/**\r
+  Called by the platform code to process a tick.\r
+\r
+  @param  Duration               The number of 100ns elapsed since the last call\r
+                                 to TimerTick\r
 \r
 **/\r
 VOID\r
-CoreInsertEventTimer (\r
-  IN IEVENT   *Event\r
+EFIAPI\r
+CoreTimerTick (\r
+  IN UINT64   Duration\r
   )\r
 {\r
-  UINT64          TriggerTime;\r
-  LIST_ENTRY      *Link;\r
-  IEVENT          *Event2;\r
+  IEVENT          *Event;\r
 \r
-  ASSERT_LOCKED (&mEfiTimerLock);\r
+  //\r
+  // Check runtiem flag in case there are ticks while exiting boot services\r
+  //\r
+  CoreAcquireLock (&mEfiSystemTimeLock);\r
 \r
   //\r
-  // Get the timer's trigger time\r
+  // Update the system time\r
   //\r
-  TriggerTime = Event->u.Timer.TriggerTime;\r
+  mEfiSystemTime += Duration;\r
 \r
   //\r
-  // Insert the timer into the timer database in assending sorted order\r
+  // If the head of the list is expired, fire the timer event\r
+  // to process it\r
   //\r
-  for (Link = mEfiTimerList.ForwardLink; Link  != &mEfiTimerList; Link = Link->ForwardLink) {\r
-    Event2 = CR (Link, IEVENT, u.Timer.Link, EVENT_SIGNATURE);\r
+  if (!IsListEmpty (&mEfiTimerList)) {\r
+    Event = CR (mEfiTimerList.ForwardLink, IEVENT, Timer.Link, EVENT_SIGNATURE);\r
 \r
-    if (Event2->u.Timer.TriggerTime > TriggerTime) {\r
-      break;\r
+    if (Event->Timer.TriggerTime <= mEfiSystemTime) {\r
+      CoreSignalEvent (mEfiCheckTimerEvent);\r
     }\r
   }\r
 \r
-  InsertTailList (Link, &Event->u.Timer.Link);\r
+  CoreReleaseLock (&mEfiSystemTimeLock);\r
 }\r
 \r
 \r
@@ -270,15 +229,15 @@ CoreInsertEventTimer (
 /**\r
   Sets the type of timer and the trigger time for a timer event.\r
 \r
-  @param  UserEvent              The timer event that is to be signaled at the \r
-                                 specified time \r
-  @param  Type                   The type of time that is specified in \r
-                                 TriggerTime \r
-  @param  TriggerTime            The number of 100ns units until the timer \r
-                                 expires \r
+  @param  UserEvent              The timer event that is to be signaled at the\r
+                                 specified time\r
+  @param  Type                   The type of time that is specified in\r
+                                 TriggerTime\r
+  @param  TriggerTime            The number of 100ns units until the timer\r
+                                 expires\r
 \r
-  @retval EFI_SUCCESS            The event has been set to be signaled at the \r
-                                 requested time \r
+  @retval EFI_SUCCESS            The event has been set to be signaled at the\r
+                                 requested time\r
   @retval EFI_INVALID_PARAMETER  Event or Type is not valid\r
 \r
 **/\r
@@ -302,7 +261,7 @@ CoreSetTimer (
     return EFI_INVALID_PARAMETER;\r
   }\r
 \r
-  if (Type < 0 || Type > TimerRelative  || !(Event->Type & EVT_TIMER)) {\r
+  if ((UINT32)Type > TimerRelative  || (Event->Type & EVT_TIMER) == 0) {\r
     return EFI_INVALID_PARAMETER;\r
   }\r
 \r
@@ -311,21 +270,24 @@ CoreSetTimer (
   //\r
   // If the timer is queued to the timer database, remove it\r
   //\r
-  if (Event->u.Timer.Link.ForwardLink != NULL) {\r
-    RemoveEntryList (&Event->u.Timer.Link);\r
-    Event->u.Timer.Link.ForwardLink = NULL;\r
+  if (Event->Timer.Link.ForwardLink != NULL) {\r
+    RemoveEntryList (&Event->Timer.Link);\r
+    Event->Timer.Link.ForwardLink = NULL;\r
   }\r
 \r
-  Event->u.Timer.TriggerTime = 0;\r
-  Event->u.Timer.Period = 0;\r
+  Event->Timer.TriggerTime = 0;\r
+  Event->Timer.Period = 0;\r
 \r
   if (Type != TimerCancel) {\r
 \r
     if (Type == TimerPeriodic) {\r
-      Event->u.Timer.Period = TriggerTime;\r
+      if (TriggerTime == 0) {\r
+        gTimer->GetTimerPeriod (gTimer, &TriggerTime);\r
+      }\r
+      Event->Timer.Period = TriggerTime;\r
     }\r
 \r
-    Event->u.Timer.TriggerTime = CoreCurrentSystemTime () + TriggerTime;\r
+    Event->Timer.TriggerTime = CoreCurrentSystemTime () + TriggerTime;\r
     CoreInsertEventTimer (Event);\r
 \r
     if (TriggerTime == 0) {\r