kernel/eka/nkern/nk_timer.cpp
changeset 266 0008ccd16016
parent 90 947f0dc9f7a8
--- a/kernel/eka/nkern/nk_timer.cpp	Thu Sep 02 21:54:16 2010 +0300
+++ b/kernel/eka/nkern/nk_timer.cpp	Fri Sep 17 08:37:04 2010 +0300
@@ -60,7 +60,15 @@
 	The expiry handler will be called in either ISR context or in the context
 	of the nanokernel timer thread (DfcThread1).
 
-    Note that NKern::TimerTicks() can be used to convert milliseconds to ticks.
+	Note that NKern::TimerTicks() can be used to convert milliseconds to ticks.
+
+	Be aware that if you are being called back in DFC context then the DFC thread
+	involved (DfcThread1) will be shared with both the kernel and other device
+	drivers.  YOU MUST DO YOUR WORK AND RETURN AS QUICKLY AS POSSIBLE in order to
+	not interfere with the internal workings of the kernel and with other device
+	drivers.  If you need to do anything more complex than signalling a semaphore
+	or similar short term processing then you may want to consider using your own
+	DFC queue.  Failure to follow these rules WILL LEAD TO INSTABILITY OF THE PHONE.
 
 	@param	aTime Timeout in nanokernel ticks
 	@param	aDfc TRUE if DFC callback required, FALSE if ISR callback required.