Click here to Skip to main content
Click here to Skip to main content

How to use SetTimer() with callback to a non-static member function

, 20 Aug 2003 GPL3
Rate this:
Please Sign up or sign in to vote.
This article describes how to use SetTimer() with a non-static member function as the callback.

Quick update...

After reviewing the comments and suggestions from a few people, I made the solution better. Look for an update to this article which uses a better approach, namely using the functions:

  • CreateWaitableTimer()
  • SetWaitableTimer()
  • WaitForMultipleObjects()

The solution based on these functions will allow multiple instances of the CSleeperThread class to run (instead of just one using the current example). So stay tuned, I'll have this article updated as soon as possible. Smile | :)

Introduction

I have seen many questions on the boards about how to properly use SetTimer(). I've also noticed that most of these questions are around how to put a thread to sleep for X seconds. One obvious answer would be to use the Sleep() function. The main drawback is, how do you gracefully shut down your thread, or cancel the Sleep() operation before the time expires.

This article is meant to address all of the above. I give an example of putting a thread to sleep using SetTimer(). The SetTimer() calls back to a non-static function. This is key, because normally you have to pass a static member to SetTimer() which means it can't access any other non-static variables or member functions of the class.

Details

Since implementing a non-static callback member is key to this, we'll go into this first. Implementing a callback to a static member function doesn't require anything different from implementing a regular C callback function. Since static member functions have the same signature as C functions with the same calling conventions, they can be referenced using just the function name.

Making a non-static callback member function is a different story, because they have a different signature than a C function. To make a non-static member function, it requires the use of two additional items:

  • A global (void*) pointer, referencing the class of the callback function
  • A wrapper function which will be passed to SetTimer()

This is actually a fairly simple implementation. First, you need to define your class:

class CSleeperThread : public CWinThread {
public:
  static VOID CALLBACK TimerProc_Wrapper( HWND hwnd, UINT uMsg, 
                                  UINT idEvent, DWORD dwTime );
  VOID CALLBACK TimerProc( HWND hwnd, 
                       UINT uMsg, UINT idEvent, DWORD dwTime );
  void ThreadMain();
  void WakeUp();
private:
  static void * pObject;
  UINT_PTR pTimer;
  CRITICAL_SECTION lock;
};

Then, don't forget to include the following line in your class implementation file:

void * CSleeperThread::pObject;

Now that we have our class declared, we can look at the wrapper function, the non-static member function and the member function that will call SetTimer():

VOID CALLBACK CSleeperThread::TimerProc_Wrapper( HWND hwnd, UINT uMsg, 
                                           UINT idEvent, DWORD dwTime ) {
 CSleeperThread *pSomeClass = (CSleeperThread*)pObject; // cast the void pointer
 pSomeClass->TimerProc(hwnd, uMsg, idEvent, dwTime); // call non-static function
}

The wrapper function first initializes a CSleeperThread pointer with pObject. Since pSomeClass is a local pointer, we can access it within the static wrapper function.

VOID CALLBACK CSleeperThread::TimerProc(HWND hwnd, 
     UINT uMsg, UINT idEvent, DWORD dwTime) {
 ::EnterCriticalSection(&lock);
 if(idEvent == pTimer) {
   KillTimer(NULL, pTimer);  // kill the timer so it won't fire again
   ResumeThread();  // resume the main thread function
 }
 ::LeaveCriticalSection(&lock);
}

The TimerProc member function isn't static, so we can access other non-static functions like ResumeThread() and we can access the private variable lock. Notice that I've entered a critical section which prevents a second timer event to enter the callback, thus ensuring that the first execution of TimerProc() will cancel out the timer.

Next, let's take a look at the main execution function, ThreadMain().

void CSleeperThread::ThreadMain()
{
  pObject = this; // VERY IMPORTANT, must be initialized before
                  // calling SetTimer()
  // call SetTimer, passing the wrapper function as the callback
  pTimer = SetTimer(NULL, NULL, 10000, TimerProc_Wrapper);
  // suspend until the timer expires
  SuspendThread();
  // the timer has expired, continue processing 
}

The first step in ThreadMain() is absolutely critical. We need to assign the class instance pointer (this) to the pObject variable. This is how the wrapper callback function will gain access to execute the non-static member function.

Next, we just call SetTimer() passing in a function pointer to our wrapper function. SetTimer() will call the wrapper function when the timer expires. The wrapper function in turn, will execute the non-static function TimerProc(), by accessing the static variable pSomeClass.

NOTE: I chose to implement a main function that will create the timer, go to sleep, continue processing and then exit when finished. This is in effect a function that will only execute once per timer. You could easily add a loop to ThreadMain() which would execute once for each timer event.

One last little function. Since we used SuspendThread() in ThreadMain(), if we need to wake up the thread (for whatever reason), all we have to do is make a call to ResumeThread(). So, I've added an access function like so:

void WakeUp() {
  ::EnterCriticalSection(&lock);
  KillTimer(NULL, pTimer);
  ResumeThread(); // wake the thread up
}

Buh dee buh dee, that's all folks...

And there we have it. A thread safe class that goes to sleep using SetTimer() and a non-static callback function; which also has the ability to wake up before the timer expires.

Hopefully, you have found this helpful. I've actually used this code in a project I'm working on now, and was in hopes someone else would get some good use out of it.

Someone once told me "you'll like programming if you like banging your head against the wall repeatedly". I've found that to be true, it took me literally several days to figure out what I've put into this article, I'm just slow I guess.

Whew, my head hurts, time for some Advil...or Ibooprofin.. or asssprin.... or something.

Credits...

I probably learned way more in the process of writing this article. So, much thanks goes to Lars Haendel for creating a web-site dedicated to understanding function pointers, without which I wouldn't know didley.

www.function-pointer.org.

License

This article, along with any associated source code and files, is licensed under The GNU General Public License (GPLv3)

Share

About the Author

mellertson

United States United States
Became hooked on programming in the 3rd grade using basic. Programming in C/C++ since 1997.
 
Fluent in the following languages and frameworks:
C / C++
PHP
MySQL using MySQLi
Objective-C
iOS Framework
OpenGL
Remedy AR System (every version since 1.0)
 
And intermediate proficiency in Java, shell scripting and HTML.

Comments and Discussions

 
GeneralSetTimer Callback Pinmemberrestricted17-Oct-08 7:22 
GeneralSetTimer never fires PinmemberMForceOne11-Jun-08 5:56 
GeneralRe: SetTimer never fires PinmemberNirupama Ravi28-Jul-08 21:49 
GeneralRe: SetTimer never fires PinmemberAleiZ19-Aug-08 4:49 
GeneralRe: SetTimer never fires - Service won't run it's Callbacks PinmemberCodeAssi5-Feb-09 2:05 
GeneralSuspendThread() cause "Debug Assertion Failed!", why Pinmembersuna59922-May-07 6:43 
QuestionMultiple Client Calling without Mapping? PinmemberGreen_Light13-Oct-06 12:30 
AnswerRe: Multiple Client Calling without Mapping? PinmemberImran_Ansari7-Feb-07 23:13 
GeneralUse of SetTimer() with callback to multiple clients PinmemberImran_Ansari6-Jun-06 22:06 
GeneralThe almost correct solution Pinmemberrezzzman17-Feb-06 12:17 
GeneralSetTimer Pinmembersubhashkjain2001@hotmail.com28-Dec-04 0:06 
QuestionHow can i use these code? Pinmemberreinkorea17-Jun-04 9:17 
AnswerRe: How can i use these code? Pinmembermellertson17-Jun-04 9:40 
QuestionRe: How can i use these code? PinmemberMForceOne10-Jun-08 14:44 
GeneralGood but question PinmemberROLKI___18-Apr-04 7:40 
GeneralRe: Good but question PinmemberGreen_Light13-Oct-06 12:24 
GeneralBad solution PinmemberJean-Michel LE FOL20-Aug-03 23:09 
GeneralIt's a good solution Pinmemberbillgatest21-Aug-03 5:54 
GeneralRe: Bad solution PinsussMike Ellertson21-Aug-03 6:45 
GeneralRe: Bad solution PinmemberPaolo Messina21-Aug-03 8:23 
GeneralRe: Bad solution Pinmembermellertson21-Aug-03 9:31 
GeneralRe: Bad solution PinmemberPaolo Messina21-Aug-03 15:34 
GeneralRe: Bad solution PinmemberZele22-Mar-04 0:53 
GeneralRe: Bad solution PinmemberJaeWook Choi8-Nov-04 9:27 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web04 | 2.8.141220.1 | Last Updated 21 Aug 2003
Article Copyright 2003 by mellertson
Everything else Copyright © CodeProject, 1999-2014
Layout: fixed | fluid