trap_x.h File Reference

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	KiExitTrapDebugChecks(x, y)
#define	KiFillTrapFrameDebug(x)

Typedefs
typedef VOID(FASTCALL *	PFAST_SYSTEM_CALL_EXIT) (IN PKTRAP_FRAME TrapFrame)

Functions
FORCEINLINE BOOLEAN	KiUserTrap (IN PKTRAP_FRAME TrapFrame)
FORCEINLINE VOID	KiDumpTrapFrame (IN PKTRAP_FRAME TrapFrame)
FORCEINLINE VOID	KiExitSystemCallDebugChecks (IN ULONG SystemCall, IN PKTRAP_FRAME TrapFrame)
DECLSPEC_NORETURN VOID FASTCALL	KiSystemCallReturn (IN PKTRAP_FRAME TrapFrame)
DECLSPEC_NORETURN VOID FASTCALL	KiSystemCallSysExitReturn (IN PKTRAP_FRAME TrapFrame)
DECLSPEC_NORETURN VOID FASTCALL	KiSystemCallTrapReturn (IN PKTRAP_FRAME TrapFrame)
DECLSPEC_NORETURN VOID FASTCALL	KiEditedTrapReturn (IN PKTRAP_FRAME TrapFrame)
DECLSPEC_NORETURN VOID FASTCALL	KiTrapReturn (IN PKTRAP_FRAME TrapFrame)
DECLSPEC_NORETURN VOID FASTCALL	KiTrapReturnNoSegments (IN PKTRAP_FRAME TrapFrame)
DECLSPEC_NORETURN VOID FASTCALL	KiTrapReturnNoSegmentsRet8 (IN PKTRAP_FRAME TrapFrame)
FORCEINLINE VOID	KiHandleDebugRegistersOnTrapEntry (IN PKTRAP_FRAME TrapFrame)
FORCEINLINE VOID	KiHandleDebugRegistersOnTrapExit (PKTRAP_FRAME TrapFrame)
FORCEINLINE DECLSPEC_NORETURN VOID	KiExitV86Trap (IN PKTRAP_FRAME TrapFrame)
FORCEINLINE VOID	KiEnterV86Trap (IN PKTRAP_FRAME TrapFrame)
FORCEINLINE VOID	KiEnterInterruptTrap (IN PKTRAP_FRAME TrapFrame)
FORCEINLINE VOID	KiEnterTrap (IN PKTRAP_FRAME TrapFrame)

Variables
PFAST_SYSTEM_CALL_EXIT	KiFastCallExitHandler

Macro Definition Documentation

KiExitTrapDebugChecks

#define KiExitTrapDebugChecks	(		x,
			y
	)

Definition at line 183 of file trap_x.h.

KiFillTrapFrameDebug

#define KiFillTrapFrameDebug

(

x

)

Definition at line 184 of file trap_x.h.

Typedef Documentation

PFAST_SYSTEM_CALL_EXIT

typedef VOID(FASTCALL * PFAST_SYSTEM_CALL_EXIT) (IN PKTRAP_FRAME TrapFrame)

Definition at line 239 of file trap_x.h.

Function Documentation

KiDumpTrapFrame()

FORCEINLINE VOID KiDumpTrapFrame

(

IN PKTRAP_FRAME

TrapFrame

)

Definition at line 31 of file trap_x.h.

{
    /* Dump the whole thing */
    DbgPrint("DbgEbp: %x\n", TrapFrame->DbgEbp);
    DbgPrint("DbgEip: %x\n", TrapFrame->DbgEip);
    DbgPrint("DbgArgMark: %x\n", TrapFrame->DbgArgMark);
    DbgPrint("DbgArgPointer: %x\n", TrapFrame->DbgArgPointer);
    DbgPrint("TempSegCs: %x\n", TrapFrame->TempSegCs);
    DbgPrint("TempEsp: %x\n", TrapFrame->TempEsp);
    DbgPrint("Dr0: %x\n", TrapFrame->Dr0);
    DbgPrint("Dr1: %x\n", TrapFrame->Dr1);
    DbgPrint("Dr2: %x\n", TrapFrame->Dr2);
    DbgPrint("Dr3: %x\n", TrapFrame->Dr3);
    DbgPrint("Dr6: %x\n", TrapFrame->Dr6);
    DbgPrint("Dr7: %x\n", TrapFrame->Dr7);
    DbgPrint("SegGs: %x\n", TrapFrame->SegGs);
    DbgPrint("SegEs: %x\n", TrapFrame->SegEs);
    DbgPrint("SegDs: %x\n", TrapFrame->SegDs);
    DbgPrint("Edx: %x\n", TrapFrame->Edx);
    DbgPrint("Ecx: %x\n", TrapFrame->Ecx);
    DbgPrint("Eax: %x\n", TrapFrame->Eax);
    DbgPrint("PreviousPreviousMode: %x\n", TrapFrame->PreviousPreviousMode);
    DbgPrint("ExceptionList: %p\n", TrapFrame->ExceptionList);
    DbgPrint("SegFs: %x\n", TrapFrame->SegFs);
    DbgPrint("Edi: %x\n", TrapFrame->Edi);
    DbgPrint("Esi: %x\n", TrapFrame->Esi);
    DbgPrint("Ebx: %x\n", TrapFrame->Ebx);
    DbgPrint("Ebp: %x\n", TrapFrame->Ebp);
    DbgPrint("ErrCode: %x\n", TrapFrame->ErrCode);
    DbgPrint("Eip: %x\n", TrapFrame->Eip);
    DbgPrint("SegCs: %x\n", TrapFrame->SegCs);
    DbgPrint("EFlags: %x\n", TrapFrame->EFlags);
    DbgPrint("HardwareEsp: %x\n", TrapFrame->HardwareEsp);
    DbgPrint("HardwareSegSs: %x\n", TrapFrame->HardwareSegSs);
    DbgPrint("V86Es: %x\n", TrapFrame->V86Es);
    DbgPrint("V86Ds: %x\n", TrapFrame->V86Ds);
    DbgPrint("V86Fs: %x\n", TrapFrame->V86Fs);
    DbgPrint("V86Gs: %x\n", TrapFrame->V86Gs);
}

Referenced by HalpTrap0DHandler().

KiEditedTrapReturn()

DECLSPEC_NORETURN VOID FASTCALL KiEditedTrapReturn

(

IN PKTRAP_FRAME

TrapFrame

)

Referenced by KiEoiHelper(), and KiServiceExit2().

KiEnterInterruptTrap()

FORCEINLINE VOID KiEnterInterruptTrap

(

IN PKTRAP_FRAME

TrapFrame

)

Definition at line 368 of file trap_x.h.

{
    PVOID ExceptionList;
 
    /* Check exception list and terminate it */
    ExceptionList = KeGetPcr()->NtTib.ExceptionList;
    ASSERTMSG("Interrupt handler must not register an SEH frame\n",
              ExceptionList == TrapFrame->ExceptionList);
    KeGetPcr()->NtTib.ExceptionList = EXCEPTION_CHAIN_END;
 
    /* Default to debugging disabled */
    TrapFrame->Dr7 = 0;
 
    /* Check if the frame was from user mode or v86 mode */
    if (KiUserTrap(TrapFrame) ||
        (TrapFrame->EFlags & EFLAGS_V86_MASK))
    {
        /* Check for active debugging */
        if (KeGetCurrentThread()->Header.DebugActive & 0xFF)
        {
            /* Handle debug registers */
            KiHandleDebugRegistersOnTrapEntry(TrapFrame);
        }
    }
 
    /* Set debug header */
    KiFillTrapFrameDebug(TrapFrame);
}

Referenced by HalpApcInterruptHandler(), HalpClockInterruptHandler(), HalpClockIpiHandler(), HalpDispatchInterruptHandler(), KiInterruptTemplateHandler(), and KiUnexpectedInterruptTailHandler().

KiEnterTrap()

FORCEINLINE VOID KiEnterTrap

(

IN PKTRAP_FRAME

TrapFrame

)

Definition at line 402 of file trap_x.h.

{
    PVOID ExceptionList;
 
    /* Check exception list */
    ExceptionList = KeGetPcr()->NtTib.ExceptionList;
    ASSERTMSG("Trap handler must not register an SEH frame\n",
              ExceptionList == TrapFrame->ExceptionList);
 
    /* Default to debugging disabled */
    TrapFrame->Dr7 = 0;
 
    /* Check if the frame was from user mode or v86 mode */
    if (KiUserTrap(TrapFrame) ||
        (TrapFrame->EFlags & EFLAGS_V86_MASK))
    {
        /* Check for active debugging */
        if (KeGetCurrentThread()->Header.DebugActive & 0xFF)
        {
            /* Handle debug registers */
            KiHandleDebugRegistersOnTrapEntry(TrapFrame);
        }
    }
 
    /* Set debug header */
    KiFillTrapFrameDebug(TrapFrame);
}

Referenced by HalpTrap0DHandler(), KiDebugServiceHandler(), KiGetTickCountHandler(), KiRaiseAssertionHandler(), KiRaiseSecurityCheckFailureHandler(), KiTrap00Handler(), KiTrap01Handler(), KiTrap03Handler(), KiTrap04Handler(), KiTrap05Handler(), KiTrap06Handler(), KiTrap07Handler(), KiTrap09Handler(), KiTrap0AHandler(), KiTrap0BHandler(), KiTrap0CHandler(), KiTrap0DHandler(), KiTrap0EHandler(), KiTrap0FHandler(), KiTrap10Handler(), KiTrap11Handler(), and KiTrap13Handler().

KiEnterV86Trap()

FORCEINLINE VOID KiEnterV86Trap

(

IN PKTRAP_FRAME

TrapFrame

)

Definition at line 345 of file trap_x.h.

{
    PVOID ExceptionList;
 
    /* Check exception list */
    ExceptionList = KeGetPcr()->NtTib.ExceptionList;
    ASSERTMSG("V86 trap handler must not register an SEH frame\n",
              ExceptionList == TrapFrame->ExceptionList);
 
    /* Save DR7 and check for debugging */
    TrapFrame->Dr7 = __readdr(7);
    if (__builtin_expect(TrapFrame->Dr7 & ~DR7_RESERVED_MASK, 0))
    {
        /* Handle debug registers */
        KiHandleDebugRegistersOnTrapEntry(TrapFrame);
    }
}

Referenced by KiTrap06Handler(), and KiTrap0DHandler().

KiExitSystemCallDebugChecks()

FORCEINLINE VOID KiExitSystemCallDebugChecks	(	IN ULONG	SystemCall,
		IN PKTRAP_FRAME	TrapFrame
	)

Definition at line 189 of file trap_x.h.

{
    KIRQL OldIrql;
 
    /* Check if this was a user call */
    if (KiUserTrap(TrapFrame))
    {
        /* Make sure we are not returning with elevated IRQL */
        OldIrql = KeGetCurrentIrql();
        if (OldIrql != PASSIVE_LEVEL)
        {
            /* Forcibly put us in a sane state */
            KeGetPcr()->Irql = PASSIVE_LEVEL;
            _disable();
 
            /* Fail */
            KeBugCheckEx(IRQL_GT_ZERO_AT_SYSTEM_SERVICE,
                         SystemCall,
                         OldIrql,
                         0,
                         0);
        }
 
        /* Make sure we're not attached and that APCs are not disabled */
        if ((KeGetCurrentThread()->ApcStateIndex != OriginalApcEnvironment) ||
            (KeGetCurrentThread()->CombinedApcDisable != 0))
        {
            /* Fail */
            KeBugCheckEx(APC_INDEX_MISMATCH,
                         SystemCall,
                         KeGetCurrentThread()->ApcStateIndex,
                         KeGetCurrentThread()->CombinedApcDisable,
                         0);
        }
    }
}

Referenced by KiSystemServiceHandler().

KiExitV86Trap()

FORCEINLINE DECLSPEC_NORETURN VOID KiExitV86Trap

(

IN PKTRAP_FRAME

TrapFrame

)

Definition at line 299 of file trap_x.h.

{
    PKTHREAD Thread;
    KIRQL OldIrql;
 
    /* Get the thread */
    Thread = KeGetCurrentThread();
    while (TRUE)
    {
        /* Return if this isn't V86 mode anymore */
        if (!(TrapFrame->EFlags & EFLAGS_V86_MASK)) KiEoiHelper(TrapFrame);
 
        /* Turn off the alerted state for kernel mode */
        Thread->Alerted[KernelMode] = FALSE;
 
        /* Are there pending user APCs? */
        if (__builtin_expect(!Thread->ApcState.UserApcPending, 1)) break;
 
        /* Raise to APC level and enable interrupts */
        OldIrql = KfRaiseIrql(APC_LEVEL);
        _enable();
 
        /* Deliver APCs */
        KiDeliverApc(UserMode, NULL, TrapFrame);
 
        /* Restore IRQL and disable interrupts once again */
        KfLowerIrql(OldIrql);
        _disable();
    }
 
    /* If we got here, we're still in a valid V8086 context, so quit it */
    if (__builtin_expect(TrapFrame->Dr7 & ~DR7_RESERVED_MASK, 0))
    {
        /* Restore debug registers from the trap frame */
        KiHandleDebugRegistersOnTrapExit(TrapFrame);
    }
 
    /* Return from interrupt */
    KiTrapReturnNoSegments(TrapFrame);
}

Referenced by KiTrap06Handler(), and KiTrap0DHandler().

KiHandleDebugRegistersOnTrapEntry()

FORCEINLINE VOID KiHandleDebugRegistersOnTrapEntry

(

IN PKTRAP_FRAME

TrapFrame

)

Definition at line 251 of file trap_x.h.

{
    PKPRCB Prcb = KeGetCurrentPrcb();
 
    /* Save all debug registers in the trap frame */
    TrapFrame->Dr0 = __readdr(0);
    TrapFrame->Dr1 = __readdr(1);
    TrapFrame->Dr2 = __readdr(2);
    TrapFrame->Dr3 = __readdr(3);
    TrapFrame->Dr6 = __readdr(6);
    TrapFrame->Dr7 = __readdr(7);
 
    /* Disable all active debugging */
    __writedr(7, 0);
 
    /* Restore kernel values */
    __writedr(0, Prcb->ProcessorState.SpecialRegisters.KernelDr0);
    __writedr(1, Prcb->ProcessorState.SpecialRegisters.KernelDr1);
    __writedr(2, Prcb->ProcessorState.SpecialRegisters.KernelDr2);
    __writedr(3, Prcb->ProcessorState.SpecialRegisters.KernelDr3);
    __writedr(6, Prcb->ProcessorState.SpecialRegisters.KernelDr6);
    __writedr(7, Prcb->ProcessorState.SpecialRegisters.KernelDr7);
}

Referenced by KiEnterInterruptTrap(), KiEnterTrap(), KiEnterV86Trap(), and KiSystemServiceHandler().

KiHandleDebugRegistersOnTrapExit()

FORCEINLINE VOID KiHandleDebugRegistersOnTrapExit

(

PKTRAP_FRAME

TrapFrame

)

Definition at line 278 of file trap_x.h.

{
    /* Disable all active debugging */
    __writedr(7, 0);
 
    /* Load all debug registers from the trap frame */
    __writedr(0, TrapFrame->Dr0);
    __writedr(1, TrapFrame->Dr1);
    __writedr(2, TrapFrame->Dr2);
    __writedr(3, TrapFrame->Dr3);
    __writedr(6, TrapFrame->Dr6);
    __writedr(7, TrapFrame->Dr7);
}

Referenced by KiCommonExit(), and KiExitV86Trap().

KiSystemCallReturn()

DECLSPEC_NORETURN VOID FASTCALL KiSystemCallReturn

(

IN PKTRAP_FRAME

TrapFrame

)

Referenced by KiServiceExit().

KiSystemCallSysExitReturn()

DECLSPEC_NORETURN VOID FASTCALL KiSystemCallSysExitReturn

(

IN PKTRAP_FRAME

TrapFrame

)

Referenced by KiRestoreFastSyscallReturnState().

KiSystemCallTrapReturn()

DECLSPEC_NORETURN VOID FASTCALL KiSystemCallTrapReturn

(

IN PKTRAP_FRAME

TrapFrame

)

Referenced by KiRestoreFastSyscallReturnState(), and KiServiceExit().

KiTrapReturn()

DECLSPEC_NORETURN VOID FASTCALL KiTrapReturn

(

IN PKTRAP_FRAME

TrapFrame

)

Referenced by KiEoiHelper(), KiServiceExit2(), and KiTrap0DHandler().

KiTrapReturnNoSegments()

DECLSPEC_NORETURN VOID FASTCALL KiTrapReturnNoSegments

(

IN PKTRAP_FRAME

TrapFrame

)

Referenced by KiEoiHelper(), KiExitV86Trap(), and KiServiceExit2().

KiTrapReturnNoSegmentsRet8()

DECLSPEC_NORETURN VOID FASTCALL KiTrapReturnNoSegmentsRet8

(

IN PKTRAP_FRAME

TrapFrame

)

Referenced by KiEoiHelper(), and KiServiceExit2().

KiUserTrap()

FORCEINLINE BOOLEAN KiUserTrap

(

IN PKTRAP_FRAME

TrapFrame

)

Definition at line 20 of file trap_x.h.

{
    /* Anything else but Ring 0 is Ring 3 */
    return !!(TrapFrame->SegCs & MODE_MASK);
}

Referenced by KiEnterInterruptTrap(), KiEnterTrap(), and KiExitSystemCallDebugChecks().

Variable Documentation

KiFastCallExitHandler

PFAST_SYSTEM_CALL_EXIT KiFastCallExitHandler

extern

Definition at line 56 of file traphdlr.c.

Referenced by KiRestoreFastSyscallReturnState(), and KiServiceExit().