pr_clearinterrupt.rst (803B)
1 PR_ClearInterrupt 2 ================= 3 4 Clears the interrupt request for the calling thread. 5 6 7 Syntax 8 ------ 9 10 .. code:: 11 12 #include <prthread.h> 13 14 void PR_ClearInterrupt(void); 15 16 17 Description 18 ----------- 19 20 Interrupting is a cooperative process, so it's possible that the thread 21 passed to :ref:`PR_Interrupt` may never respond to the interrupt request. 22 For example, the target thread may reach the agreed-on control point 23 without providing an opportunity for the runtime to notify the thread of 24 the interrupt request. In this case, the request for interrupt is still 25 pending with the thread and must be explicitly canceled. Therefore it is 26 sometimes necessary to call :ref:`PR_ClearInterrupt` to clear a previous 27 interrupt request. 28 29 If no interrupt request is pending, :ref:`PR_ClearInterrupt` is a no-op.