interrupt.c File Reference

#include <ntoskrnl.h>
#include <debug.h>

Include dependency graph for interrupt.c:

Go to the source code of this file.

Macros
#define	NDEBUG

Functions
void	KiInterruptDispatch (void)
VOID NTAPI	KeInitializeInterrupt (IN PKINTERRUPT Interrupt, IN PKSERVICE_ROUTINE ServiceRoutine, IN PVOID ServiceContext, IN PKSPIN_LOCK SpinLock, IN ULONG Vector, IN KIRQL Irql, IN KIRQL SynchronizeIrql, IN KINTERRUPT_MODE InterruptMode, IN BOOLEAN ShareVector, IN CHAR ProcessorNumber, IN BOOLEAN FloatingSave)
BOOLEAN NTAPI	KeConnectInterrupt (IN PKINTERRUPT Interrupt)
BOOLEAN NTAPI	KeDisconnectInterrupt (IN PKINTERRUPT Interrupt)
BOOLEAN NTAPI	KeSynchronizeExecution (IN OUT PKINTERRUPT Interrupt, IN PKSYNCHRONIZE_ROUTINE SynchronizeRoutine, IN PVOID SynchronizeContext OPTIONAL)

Variables
UCHAR	KiInterruptDispatchTemplate [16]
UCHAR	KiUnexpectedRange []
UCHAR	KiUnexpectedRangeEnd []

Macro Definition Documentation

NDEBUG

#define NDEBUG

Definition at line 16 of file interrupt.c.

Function Documentation

KeConnectInterrupt()

BOOLEAN NTAPI KeConnectInterrupt

(

IN PKINTERRUPT

Interrupt

)

Definition at line 81 of file interrupt.c.

{
    PVOID CurrentHandler;
    PKINTERRUPT ConnectedInterrupt;

    ASSERT(Interrupt->Vector >= PRIMARY_VECTOR_BASE);
    ASSERT(Interrupt->Vector <= MAXIMUM_IDTVECTOR);
    ASSERT(Interrupt->Number < KeNumberProcessors);
    ASSERT(Interrupt->Irql <= HIGH_LEVEL);
    ASSERT(Interrupt->SynchronizeIrql >= Interrupt->Irql);
    ASSERT(Interrupt->Irql == (Interrupt->Vector >> 4));

    /* Check if its already connected */
    if (Interrupt->Connected) return TRUE;

    /* Query the current handler */
    CurrentHandler = KeQueryInterruptHandler(Interrupt->Vector);

    /* Check if the vector is unused */
    if ((CurrentHandler >= (PVOID)KiUnexpectedRange) &&
        (CurrentHandler <= (PVOID)KiUnexpectedRangeEnd))
    {
        /* Initialize the list for chained interrupts */
        InitializeListHead(&Interrupt->InterruptListEntry);

        /* Set normal dispatch address */
        Interrupt->DispatchAddress = KiInterruptDispatch;

        /* Set the new handler */
        KeRegisterInterruptHandler(Interrupt->Vector,
                                   Interrupt->DispatchCode);

        /* Enable the interrupt */
        if (!HalEnableSystemInterrupt(Interrupt->Vector,
                                      Interrupt->Irql,
                                      Interrupt->Mode))
        {
            /* Didn't work, restore old handler */
            DPRINT1("HalEnableSystemInterrupt failed\n");
            KeRegisterInterruptHandler(Interrupt->Vector, CurrentHandler);
            return FALSE;
        }
    }
    else
    {
        /* Get the connected interrupt */
        ConnectedInterrupt = CONTAINING_RECORD(CurrentHandler, KINTERRUPT, DispatchCode);

        /* Check if sharing is ok */
        if ((Interrupt->ShareVector == 0) ||
            (ConnectedInterrupt->ShareVector == 0) ||
            (Interrupt->Mode != ConnectedInterrupt->Mode))
        {
            return FALSE;
        }

        /* Insert the new interrupt into the connected interrupt's list */
        InsertTailList(&ConnectedInterrupt->InterruptListEntry,
                       &Interrupt->InterruptListEntry);
    }

    /* Mark as connected */
    Interrupt->Connected = TRUE;

    return TRUE;
}

Referenced by IoConnectInterrupt().

KeDisconnectInterrupt()

BOOLEAN NTAPI KeDisconnectInterrupt

(

IN PKINTERRUPT

Interrupt

)

Definition at line 150 of file interrupt.c.

{
    /* If the interrupt wasn't connected, there's nothing to do */
    if (!Interrupt->Connected)
    {
        return FALSE;
    }

    UNIMPLEMENTED;
    __debugbreak();
    return TRUE;
}

Referenced by IoDisconnectInterrupt().

KeInitializeInterrupt()

VOID NTAPI KeInitializeInterrupt	(	IN PKINTERRUPT	Interrupt,
		IN PKSERVICE_ROUTINE	ServiceRoutine,
		IN PVOID	ServiceContext,
		IN PKSPIN_LOCK	SpinLock,
		IN ULONG	Vector,
		IN KIRQL	Irql,
		IN KIRQL	SynchronizeIrql,
		IN KINTERRUPT_MODE	InterruptMode,
		IN BOOLEAN	ShareVector,
		IN CHAR	ProcessorNumber,
		IN BOOLEAN	FloatingSave
	)

Definition at line 29 of file interrupt.c.

{

    /* Initialize the header */
    Interrupt->Type = InterruptObject;
    Interrupt->Size = sizeof(KINTERRUPT);

    /* If no Spinlock is given, use the internal */
    if (!SpinLock) SpinLock = &Interrupt->SpinLock;
    KeInitializeSpinLock(&Interrupt->SpinLock);

    /* Set the given parameters */
    Interrupt->ServiceRoutine = ServiceRoutine;
    Interrupt->ServiceContext = ServiceContext;
    Interrupt->ActualLock = SpinLock;
    Interrupt->Vector = Vector;
    Interrupt->Irql = Irql;
    Interrupt->SynchronizeIrql = SynchronizeIrql;
    Interrupt->Mode = InterruptMode;
    Interrupt->ShareVector = ShareVector;
    Interrupt->Number = ProcessorNumber;
    Interrupt->FloatingSave = FloatingSave;

    /* Set initial values */
    Interrupt->TickCount = 0;
    Interrupt->Connected = FALSE;
    Interrupt->ServiceCount = 0;
    Interrupt->DispatchCount = 0;
    Interrupt->TrapFrame = NULL;
    Interrupt->Reserved = 0;

    /* Copy the dispatch code (its location independent, no need to patch it) */
    RtlCopyMemory(Interrupt->DispatchCode,
                  KiInterruptDispatchTemplate,
                  sizeof(Interrupt->DispatchCode));

    Interrupt->DispatchAddress = 0;
}

Referenced by IoConnectInterrupt().

KeSynchronizeExecution()

BOOLEAN NTAPI KeSynchronizeExecution	(	IN OUT PKINTERRUPT	Interrupt,
		IN PKSYNCHRONIZE_ROUTINE	SynchronizeRoutine,
		IN PVOID SynchronizeContext	OPTIONAL
	)

Definition at line 165 of file interrupt.c.

{
    BOOLEAN Success;
    KIRQL OldIrql;

    /* Raise IRQL */
    OldIrql = KfRaiseIrql(Interrupt->SynchronizeIrql);

    /* Acquire interrupt spinlock */
    KeAcquireSpinLockAtDpcLevel(Interrupt->ActualLock);

    /* Call the routine */
    Success = SynchronizeRoutine(SynchronizeContext);

    /* Release lock */
    KeReleaseSpinLockFromDpcLevel(Interrupt->ActualLock);

    /* Lower IRQL */
    KeLowerIrql(OldIrql);

    /* Return status */
    return Success;
}

Referenced by _SynchronizeExecution(), FdoCallHWInitialize(), InPortRemoveDevice(), InPortStartDevice(), KspSynchronizedEventRoutine(), NdisMSynchronizeWithInterrupt(), ScsiPortAllocateAdapterChannel(), ScsiPortDpcForIsr(), ScsiPortIoTimer(), ScsiPortStartIo(), SerialDeviceControl(), SpiAdapterControl(), StreamClassStartDevice(), TestSynchronizeExecution(), and VideoPortSynchronizeExecution().

KiInterruptDispatch()

void KiInterruptDispatch

(

void

)

Referenced by KeConnectInterrupt().

Variable Documentation

KiInterruptDispatchTemplate

UCHAR KiInterruptDispatchTemplate[16]

Referenced by KeInitializeInterrupt().

KiUnexpectedRange

UCHAR KiUnexpectedRange[]

Referenced by KeConnectInterrupt().

KiUnexpectedRangeEnd

UCHAR KiUnexpectedRangeEnd[]

Referenced by KeConnectInterrupt().