KeSynchronizeExecution

BOOLEAN
    KeSynchronizeExecution(
        IN PKINTERRUPT  Interrupt,
        IN PKSYNCHRONIZE_ROUTINE  SynchronizeRoutine,
        IN PVOID  SynchronizeContext
        );

KeSynchronizeExecution synchronizes the execution of a given routine with that of the ISR associated with the given interrupt object pointer.

Parameters

Interrupt

Is a pointer to a set of interrupt objects. This pointer was returned by IoConnectInterrupt.

SynchronizeRoutine

Is the entry point for a caller-supplied SynchCritSection routine whose execution is to be synchronized with the execution of the ISR associated with the interrupt object(s). A SynchronizeRoutine is declared as follows:

BOOLEAN
(*PKSYNCHRONIZE_ROUTINE) (
    IN PVOID SynchronizeContext
    );

SynchronizeContext

Points to a caller-supplied context area to be passed to the SynchronizeRoutine when it is called.

Return Value

KeSynchronizeExecution returns TRUE if the operation succeeds.

Comments

When this routine is called, the following occurs:

1. The IRQL is raised to the SynchronizeIrql specified in the call to IoConnectInterrupt.

2. Access to SynchronizeContext is synchronized with the corresponding ISR by acquiring the associated interrupt object spin lock.

3. The specified SynchronizeRoutine is called with the input pointer to SynchronizeContext.

The caller-supplied SynchronizeRoutine runs at DIRQL, so it must execute very quickly.

Callers of KeSynchronizeExecution must be running at IRQL <= DIRQL, that is, less than or equal to the value of the SynchronizeIrql parameter specified when the caller registered its ISR(s) with IoConnectInterrupt.

See Also

IoConnectInterrupt