debug.c File Reference

#include <freeldr.h>
#include <debug.h>

Include dependency graph for debug.c:

Go to the source code of this file.

Functions
ULONG	DbgPrint (PCCH Format,...)
ULONG	MsgBoxPrint (const char *Format,...)
DECLSPEC_NORETURN VOID NTAPI	KeBugCheckEx (IN ULONG BugCheckCode, IN ULONG_PTR BugCheckParameter1, IN ULONG_PTR BugCheckParameter2, IN ULONG_PTR BugCheckParameter3, IN ULONG_PTR BugCheckParameter4)
VOID NTAPI	RtlAssert (IN PVOID FailedAssertion, IN PVOID FileName, IN ULONG LineNumber, IN PCHAR Message OPTIONAL)

Variables
char *	BugCodeStrings []
ULONG_PTR	BugCheckInfo [5]

Function Documentation

DbgPrint()

ULONG DbgPrint	(	PCCH	Format,
			...
	)

Definition at line 416 of file debug.c.

{
    return 0;
}

Referenced by BlStatusPrint(), ClassDebugPrint(), Fast486DumpState(), PciDebugDumpQueryCapabilities(), and RtlAssert().

KeBugCheckEx()

DECLSPEC_NORETURN VOID NTAPI KeBugCheckEx	(	IN ULONG	BugCheckCode,
		IN ULONG_PTR	BugCheckParameter1,
		IN ULONG_PTR	BugCheckParameter2,
		IN ULONG_PTR	BugCheckParameter3,
		IN ULONG_PTR	BugCheckParameter4
	)

Definition at line 456 of file debug.c.

{
    char Buffer[70];

    sprintf(Buffer,
            "*** STOP: 0x%08lX (0x%p,0x%p,0x%p,0x%p)",
            BugCheckCode,
            (PVOID)BugCheckParameter1,
            (PVOID)BugCheckParameter2,
            (PVOID)BugCheckParameter3,
            (PVOID)BugCheckParameter4);

    UiMessageBoxCritical(Buffer);
    ASSERT(FALSE);
    for (;;);
}

MsgBoxPrint()

ULONG MsgBoxPrint	(	const char *	Format,
			...
	)

Definition at line 424 of file debug.c.

{
    va_list ap;
    CHAR Buffer[512];
    ULONG Length;

    va_start(ap, Format);

    /* Construct a string */
    Length = _vsnprintf(Buffer, 512, Format, ap);

    /* Check if we went past the buffer */
    if (Length == MAXULONG)
    {
        /* Terminate it if we went over-board */
        Buffer[sizeof(Buffer) - 1] = '\n';

        /* Put maximum */
        Length = sizeof(Buffer);
    }

    /* Show it as a message box */
    UiMessageBox(Buffer);

    /* Cleanup and exit */
    va_end(ap);
    return 0;
}

RtlAssert()

VOID NTAPI RtlAssert	(	IN PVOID	FailedAssertion,
		IN PVOID	FileName,
		IN ULONG	LineNumber,
		IN PCHAR Message	OPTIONAL
	)

Definition at line 480 of file debug.c.

{
    if (Message)
    {
        DbgPrint("Assertion \'%s\' failed at %s line %lu: %s\n",
                 (PCHAR)FailedAssertion,
                 (PCHAR)FileName,
                 LineNumber,
                 Message);
    }
    else
    {
        DbgPrint("Assertion \'%s\' failed at %s line %lu\n",
                 (PCHAR)FailedAssertion,
                 (PCHAR)FileName,
                 LineNumber);
    }

    DbgBreakPoint();
}

Referenced by USBPORT_AssertFailure().

Variable Documentation

BugCheckInfo

ULONG_PTR BugCheckInfo[5]

Definition at line 512 of file debug.c.

Referenced by FrLdrBugCheckEx().

BugCodeStrings

char* BugCodeStrings[]

Initial value:

=
{
    "TEST_BUGCHECK",
    "MISSING_HARDWARE_REQUIREMENTS",
    "FREELDR_IMAGE_CORRUPTION",
    "MEMORY_INIT_FAILURE",
}

Definition at line 504 of file debug.c.

Referenced by FrLdrBugCheckEx(), and FrLdrBugCheckWithMessage().