callback.h File Reference

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

Go to the source code of this file.

Classes
struct	_CALLBACK16

Macros
#define	BOP(num)   LOBYTE(EMULATOR_BOP), HIBYTE(EMULATOR_BOP), (num)
#define	UnSimulate16(trap)
#define	TRAMPOLINE_SIZE   sizeof(ULONGLONG)

Typedefs
typedef struct _CALLBACK16	CALLBACK16
typedef struct _CALLBACK16 *	PCALLBACK16

Functions
VOID	InitializeContextEx (IN PCALLBACK16 Context, IN ULONG TrampolineSize, IN USHORT Segment, IN USHORT Offset)
VOID	InitializeContext (IN PCALLBACK16 Context, IN USHORT Segment, IN USHORT Offset)
VOID	Call16 (IN USHORT Segment, IN USHORT Offset)
VOID	RunCallback16 (IN PCALLBACK16 Context, IN ULONG FarPtr)
ULONG	RegisterCallback16 (IN ULONG FarPtr, IN LPBYTE CallbackCode, IN SIZE_T CallbackSize, OUT PSIZE_T CodeSize OPTIONAL)

Macro Definition Documentation

BOP

#define BOP

(

num

)

LOBYTE(EMULATOR_BOP), HIBYTE(EMULATOR_BOP), (num)

Definition at line 15 of file callback.h.

TRAMPOLINE_SIZE

#define TRAMPOLINE_SIZE   sizeof(ULONGLONG)

Definition at line 24 of file callback.h.

UnSimulate16

#define UnSimulate16

(

trap

)

Value:

do {                                 \
    *(PUSHORT)(trap) = EMULATOR_BOP; \
    (trap) += sizeof(USHORT);        \
    *(trap) = BOP_UNSIMULATE;        \
} while(0)

Definition at line 16 of file callback.h.

Typedef Documentation

CALLBACK16

typedef struct _CALLBACK16 CALLBACK16

PCALLBACK16

typedef struct _CALLBACK16 * PCALLBACK16

Function Documentation

Call16()

VOID Call16	(	IN USHORT	Segment,
		IN USHORT	Offset
	)

Definition at line 71 of file callback.c.

{
    /* Save CS:IP */
    USHORT OrgCS = getCS();
    USHORT OrgIP = getIP();
 
    /* Set the new CS:IP */
    setCS(Segment);
    setIP(Offset);
 
    DPRINT("Call16(%04X:%04X)\n", Segment, Offset);
 
    /* Start CPU simulation */
    CpuSimulate();
 
    /* Restore CS:IP */
    setCS(OrgCS);
    setIP(OrgIP);
}

Referenced by Int32Call(), and RunCallback16().

InitializeContext()

VOID InitializeContext	(	IN PCALLBACK16	Context,
		IN USHORT	Segment,
		IN USHORT	Offset
	)

Definition at line 60 of file callback.c.

{
    InitializeContextEx(Context,
                        TRAMPOLINE_SIZE,
                        Segment,
                        Offset);
}

Referenced by DosBootsectorInitialize(), DosKRNLInitialize(), DosMouseInitialize(), DosStart(), InitializeBiosInt32(), and KsCreateDefaultAllocatorEx().

InitializeContextEx()

VOID InitializeContextEx	(	IN PCALLBACK16	Context,
		IN ULONG	TrampolineSize,
		IN USHORT	Segment,
		IN USHORT	Offset
	)

Definition at line 48 of file callback.c.

{
    Context->TrampolineFarPtr = MAKELONG(Offset, Segment);
    Context->TrampolineSize   = max(TRAMPOLINE_SIZE, TrampolineSize);
    Context->Segment          = Segment;
    Context->NextOffset       = Offset + Context->TrampolineSize;
}

Referenced by InitializeContext().

RegisterCallback16()

ULONG RegisterCallback16	(	IN ULONG	FarPtr,
		IN LPBYTE	CallbackCode,
		IN SIZE_T	CallbackSize,
		OUT PSIZE_T CodeSize	OPTIONAL
	)

Definition at line 120 of file callback.c.

{
    LPBYTE CodeStart = (LPBYTE)FAR_POINTER(FarPtr);
    LPBYTE Code      = CodeStart;
 
    SIZE_T OurCodeSize = CallbackSize;
 
    if (CallbackCode == NULL) CallbackSize = 0;
 
    if (CallbackCode)
    {
        /* 16-bit interrupt code */
        RtlCopyMemory(Code, CallbackCode, CallbackSize);
        Code += CallbackSize;
    }
 
    /* Return the real size of the code if needed */
    if (CodeSize) *CodeSize = OurCodeSize; // == (ULONG_PTR)Code - (ULONG_PTR)CodeStart;
 
    // /* Return the entry-point address for 32-bit calls */
    // return (ULONG_PTR)(CodeStart + CallbackSize);
    return OurCodeSize;
}

Referenced by RegisterInt16().

RunCallback16()

VOID RunCallback16	(	IN PCALLBACK16	Context,
		IN ULONG	FarPtr
	)

Definition at line 93 of file callback.c.

{
    PUCHAR TrampolineBase = (PUCHAR)FAR_POINTER(Context->TrampolineFarPtr);
    PUCHAR Trampoline     = TrampolineBase;
    UCHAR  OldTrampoline[TRAMPOLINE_SIZE];
 
    /* Save the old trampoline */
    ((PULONGLONG)&OldTrampoline)[0] = ((PULONGLONG)TrampolineBase)[0];
 
    DPRINT("RunCallback16(0x%p)\n", FarPtr);
 
    /* Build the generic entry-point for 16-bit far calls */
    *Trampoline++ = 0x9A; // Call far seg:off
    *(PULONG)Trampoline = FarPtr;
    Trampoline += sizeof(ULONG);
    UnSimulate16(Trampoline);
 
    /* Perform the call */
    Call16(HIWORD(Context->TrampolineFarPtr),
           LOWORD(Context->TrampolineFarPtr));
 
    /* Restore the old trampoline */
    ((PULONGLONG)TrampolineBase)[0] = ((PULONGLONG)&OldTrampoline)[0];
}

Referenced by BiosMouseIrq(), CallMouseUserHandlers(), DosCallDriver(), and InitRomRange().