1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-0422EDC4-E17C-5E58-BB37-03CCA79ED3E9" xml:lang="en"><title>How

    13 to Wait for a Given Time Period</title><shortdesc>Explains how to use timers to suspend a thread for a given time

    14 period.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    15 <p>Once the timer has been created and initialised, a request can be set up.</p>

    16 <ul>

    17 <li id="GUID-252BD68A-05F6-57D0-98E1-4BE2B0B7D2D6"><p>start the timer to complete

    18 after a set period by calling <codeph>After()</codeph>, passing the required

    19 period in microseconds</p> </li>

    20 <li id="GUID-7D5F4F30-6AD5-5532-A9BE-015EE4632842"><p>call <codeph>User::WaitForRequest()</codeph> to

    21 wait for completion</p> </li>

    22 </ul>

    23 <p>In the following example, the thread is suspended for a 1 second. <codeph>timerStatus</codeph> is

    24 a <codeph>TRequestStatus</codeph>.</p>

    25 <codeblock id="GUID-4F3CC22C-220D-5B29-8335-2757C47C8763" xml:space="preserve">timer.After(timerStatus,1000000);

    26 User::WaitForRequest(timerStatus); 

    27 </codeblock>

    28 </conbody></concept>