feat(interrupts): SRI triggered when SP back to wait

Implement the action to trigger SRI when SP goes into
waiting state while there are pending interrupts.

Signed-off-by: J-Alves <joao.alves@arm.com>
Change-Id: Ie983e8d22355a51e55dde0089ac6330982bb89a1
diff --git a/src/api.c b/src/api.c
index 494cfef..c39e3fb 100644
--- a/src/api.c
+++ b/src/api.c
@@ -3161,9 +3161,10 @@
 							 next_locked);
 
 	/*
-	 * Check if there is a pending secure interrupt.
-	 * If there is, return back to the caller with FFA_INTERRUPT,
-	 * and set the `next` vcpu in a preempted state.
+	 * Check if there is a pending interrupt, and if the partition
+	 * is expects to notify the scheduler or resume straight away.
+	 * Either trigger SRI for later donation of CPU cycles, or
+	 * eret `FFA_INTERRUPT` back to the caller.
 	 */
 	if (ffa_interrupts_intercept_call(current_locked, next_locked,
 					  &signal_interrupt)) {