IInterruptSync::CallSynchronizedRoutine method (portcls.h)

Article
02/22/2024

The CallSynchronizedRoutine method calls a routine that is not an interrupt service routine (ISR) but whose execution needs to be synchronized with ISRs.

Syntax

NTSTATUS CallSynchronizedRoutine(
  [in] PINTERRUPTSYNCROUTINE Routine,
  [in] PVOID                 DynamicContext
);

Parameters

[in] Routine

Pointer to the routine that is to be called. This routine will run exclusive of the object's ISR and all other routines that are synchronized through the object. Even on multiple-processor machines, routines that are synchronized by a given object will not run concurrently. This parameter is a function pointer of type PINTERRUPTSYNCROUTINE (see IInterruptSync).

[in] DynamicContext

A context value to be passed to the routine.

Return value

CallSynchronizedRoutine returns STATUS_SUCCESS if the call was successful. Otherwise, the method returns an appropriate error code.

Remarks

Execution of any registered ISR is guaranteed to be held off until the call to the routine that is passed to CallSynchronizedRoutine has completed.

Callers of CallSynchronizedRoutine must be running at an IRQL that is less than or equal to the level of the interrupt that is associated with the synchronization object. This interrupt was specified by the PcNewInterruptSync function's ResourceList and ResourceIndex parameters.

Requirements

Requirement	Value
Target Platform	Universal
Header	portcls.h (include Portcls.h)
IRQL	See Remarks section.