NdisMSynchronizeWithInterrupt

This function synchronizes execution of a Miniport-supplied function with the MiniportISR or the MiniportDisableInterrupt function.

At a Glance

Header file:	Ndis.h
Windows CE versions:	2.0 and later

Syntax

BOOLEAN NdisMSynchronizeWithInterrupt(
IN PNDIS_MINIPORT_INTERRUPT Interrupt,
IN PVOID SynchronizeFunction, IN PVOID SynchronizeContext );

Parameters

Interrupt: Pointer to the caller-supplied storage for the interrupt object initialized with the NdisMRegisterInterrupt function.
SynchronizeFunction: Specifies the entry point of the driver’s MiniportSynchronizeISR function.
SynchronizeContext: Pointer to a miniport-determined context area to be passed to the MiniportSynchronizeISR function when it is called.

Return Values

Returns the Boolean value returned by MiniportSynchronizeISR.

Remarks

The value returned by MiniportSynchronizeISR is also returned by this function. This propagated value can be used to provide a status to the caller.

Any miniport function that shares resources with any other driver function that runs at DIRQL must use this function to synchronize its access to those resources. The MiniportSynchronizeISR function also runs at DIRQL, and the shared resources are protected by a system-allocated spin lock on multiprocessor platforms. Thus, the shared resources are protected from simultaneous access by MiniportISR or MiniportDisableInterrupt and the caller whenever the driver is running on a multiprocessor platform.

This function releases the system spin lock and restores the original IRQL of its caller before it returns control.

A driver that calls this function runs at IRQL <= DIRQL.