7 Nokia Corporation - initial contribution. |
7 Nokia Corporation - initial contribution. |
8 Contributors: |
8 Contributors: |
9 --> |
9 --> |
10 <!DOCTYPE concept |
10 <!DOCTYPE concept |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
12 <concept id="GUID-27F345DA-7969-5B3B-B2BD-285CD168CF72" xml:lang="en"><title>Timers |
12 <concept id="GUID-27F345DA-7969-5B3B-B2BD-285CD168CF72" xml:lang="en"><title>Timers And Timing Services Overview</title><shortdesc>Provides timers that asynchronously notify an application |
13 And Timing Services Overview</title><shortdesc>Provides timers that asynchronously notify an application after |
13 after an interval or at a specific time.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
14 an interval or at a specific time.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
14 <section id="GUID-48022E0B-8764-4944-8CFF-5EE6956DBC7C"><title>Architectural |
15 <section id="GUID-48022E0B-8764-4944-8CFF-5EE6956DBC7C"><title>Architectural relationships</title> <p>The <xref href="GUID-C197C9A7-EA05-3F24-9854-542E984C612D.dita"><apiname>User</apiname></xref> class |
15 relationships</title> <p>The <xref href="GUID-C197C9A7-EA05-3F24-9854-542E984C612D.dita"><apiname>User</apiname></xref> class in the |
16 in the System Static Functions API provides simple functions to suspend a |
16 System Static Functions API provides simple functions to suspend a |
17 thread for a given interval or until a specific time.</p> </section> |
17 thread for a given interval or until a specific time.</p> </section> |
18 <section id="GUID-59820FCE-FEF5-4089-8B62-1E1D8328437A"><title>Description</title> <p>The API has three key concepts: simple |
18 <section id="GUID-59820FCE-FEF5-4089-8B62-1E1D8328437A"><title>Description</title> <p>The API has three key concepts: simple timer, periodic timer, |
19 timer, periodic timer, and heartbeat timer. </p> </section> |
19 and heartbeat timer. </p> </section> |
20 <section id="GUID-4CD59C91-C827-4C5A-98D4-509CBD3948EA"><title>Simple timer</title> <p>The simple timer produces an event |
20 <section id="GUID-4CD59C91-C827-4C5A-98D4-509CBD3948EA"><title>Simple |
21 at a given system time or after a given interval. It is provided by <xref href="GUID-8A423EA2-4264-30C9-9579-0466994E6E88.dita"><apiname>RTimer</apiname></xref>. |
21 timer</title> <p>The simple timer produces an event at a given system |
22 This service is wrapped in an active object by <xref href="GUID-5733DF34-5B54-3044-BBED-3BFECB7ACE7A.dita"><apiname>CTimer</apiname></xref>.</p> </section> |
22 time or after a given interval. It is provided by <xref href="GUID-8A423EA2-4264-30C9-9579-0466994E6E88.dita"><apiname>RTimer</apiname></xref>. This service is wrapped in an active object by <xref href="GUID-5733DF34-5B54-3044-BBED-3BFECB7ACE7A.dita"><apiname>CTimer</apiname></xref>.</p> </section> |
23 <section id="GUID-D44976FF-8171-47B8-A211-66541247F256"><title>Periodic timer</title><p><b/> </p> <p>A periodic timer |
23 <section id="GUID-D44976FF-8171-47B8-A211-66541247F256"><title>Periodic |
24 produces a sequence of events at a specified interval. The application is |
24 timer</title><p><b/> </p> <p>A periodic timer produces a sequence |
25 called through a callback (<xref href="GUID-6C5766BC-05DE-32A8-993D-6BB582931F43.dita"><apiname>TCallBack</apiname></xref>) when they occur. |
25 of events at a specified interval. The application is called through |
26 It is provided by <xref href="GUID-3CECC9FC-58C1-3117-AAF2-FDF88341F56F.dita"><apiname>CPeriodic</apiname></xref>.</p> </section> |
26 a callback (<xref href="GUID-6C5766BC-05DE-32A8-993D-6BB582931F43.dita"><apiname>TCallBack</apiname></xref>) when they occur. It is provided |
27 <section id="GUID-3D6DC89E-DE6A-4AE1-84E8-870AF4B70FC3"><title>Heartbeat timer</title> <p>A heartbeat timer is similar to |
27 by <xref href="GUID-3CECC9FC-58C1-3117-AAF2-FDF88341F56F.dita"><apiname>CPeriodic</apiname></xref>.</p> </section> |
28 a periodic timer. However, if the application is busy handling another event |
28 <section id="GUID-3D6DC89E-DE6A-4AE1-84E8-870AF4B70FC3"><title>Heartbeat |
29 when the timer event occurs, a periodic timer simple delays delivering the |
29 timer</title> <p>A heartbeat timer is similar to a periodic timer. |
30 event, while a heartbeat timer will inform the application that it has missed |
30 However, if the application is busy handling another event when the |
31 the event. </p> <p>It is provided by <xref href="GUID-12C497F2-DB51-3740-972C-11ACD6501DAB.dita"><apiname>CHeartbeat</apiname></xref>. Applications |
31 timer event occurs, a periodic timer simple delays delivering the |
32 are alerted to timer events through implementing an interface <xref href="GUID-6DE7027A-54C0-33F1-B184-7070B1A85709.dita"><apiname>MBeating</apiname></xref>.</p> </section> |
32 event, while a heartbeat timer will inform the application that it |
|
33 has missed the event. </p> <p>It is provided by <xref href="GUID-12C497F2-DB51-3740-972C-11ACD6501DAB.dita"><apiname>CHeartbeat</apiname></xref>. Applications are alerted to timer events through implementing an |
|
34 interface <xref href="GUID-6DE7027A-54C0-33F1-B184-7070B1A85709.dita"><apiname>MBeating</apiname></xref>.</p> </section> |
33 </conbody><related-links> |
35 </conbody><related-links> |
34 <link> |
36 <link href="GUID-1294F540-FDA7-5050-BAFB-3C9888491B98.dita"> |
35 <desc><xref href="GUID-1294F540-FDA7-5050-BAFB-3C9888491B98.dita">Asynchronous |
37 <linktext>Asynchronous Services Overview</linktext></link> |
36 Services Overview</xref></desc> |
38 <link href="GUID-FF8F5D97-7D37-5F6B-84A3-C064E2FD53E0.dita"><linktext>System |
37 </link> |
39 Static Functions Overview</linktext></link> |
38 <link href="GUID-FF8F5D97-7D37-5F6B-84A3-C064E2FD53E0.dita"><linktext>System Static |
|
39 Functions Overview</linktext></link> |
|
40 </related-links></concept> |
40 </related-links></concept> |