kdbg.c File Reference

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

Include dependency graph for kdbg.c:

Go to the source code of this file.

Macros
#define	NDEBUG
#define	DEFAULT_BAUD_RATE   19200
#define	MAX_COM_PORTS   (sizeof(BaseArray) / sizeof(BaseArray[0]) - 1)

Functions
BOOLEAN NTAPI	KdPortInitializeEx (IN PCPPORT PortInformation, IN ULONG ComPortNumber)
BOOLEAN NTAPI	KdPortGetByteEx (IN PCPPORT PortInformation, OUT PUCHAR ByteReceived)
VOID NTAPI	KdPortPutByteEx (IN PCPPORT PortInformation, IN UCHAR ByteToSend)

Macro Definition Documentation

DEFAULT_BAUD_RATE

#define DEFAULT_BAUD_RATE   19200

Definition at line 19 of file kdbg.c.

MAX_COM_PORTS

#define MAX_COM_PORTS   (sizeof(BaseArray) / sizeof(BaseArray[0]) - 1)

Definition at line 38 of file kdbg.c.

NDEBUG

#define NDEBUG

Definition at line 13 of file kdbg.c.

Function Documentation

KdPortGetByteEx()

BOOLEAN NTAPI KdPortGetByteEx	(	IN PCPPORT	PortInformation,
		OUT PUCHAR	ByteReceived
	)

Definition at line 130 of file kdbg.c.

{
    return (CpGetByte(PortInformation, ByteReceived, FALSE, FALSE) == CP_GET_SUCCESS);
}

KdPortInitializeEx()

BOOLEAN NTAPI KdPortInitializeEx	(	IN PCPPORT	PortInformation,
		IN ULONG	ComPortNumber
	)

Definition at line 51 of file kdbg.c.

{
    NTSTATUS Status;

#if 0 // Deactivated because never used in fact (was in KdPortInitialize but we use KdPortInitializeEx)
    /*
     * Find the port if needed
     */

    if (!PortInitialized)
    {
        DefaultPort.BaudRate = PortInformation->BaudRate;

        if (ComPortNumber == 0)
        {
            /*
             * Start enumerating COM ports from the last one to the first one,
             * and break when we find a valid port.
             * If we reach the first element of the list, the invalid COM port,
             * then it means that no valid port was found.
             */
            for (ComPortNumber = MAX_COM_PORTS; ComPortNumber > 0; ComPortNumber--)
            {
                if (CpDoesPortExist(UlongToPtr(BaseArray[ComPortNumber])))
                {
                    PortInformation->Address = DefaultPort.Address = BaseArray[ComPortNumber];
                    break;
                }
            }
            if (ComPortNumber == 0)
            {
                HalDisplayString("\r\nKernel Debugger: No COM port found!\r\n\r\n");
                return FALSE;
            }
        }

        PortInitialized = TRUE;
    }
#endif

    /*
     * Initialize the port
     */
    Status = CpInitialize(PortInformation,
                          (ComPortNumber == 0 ? PortInformation->Address
                                              : UlongToPtr(BaseArray[ComPortNumber])),
                          (PortInformation->BaudRate == 0 ? DEFAULT_BAUD_RATE
                                                          : PortInformation->BaudRate));
    if (!NT_SUCCESS(Status))
    {
        HalDisplayString("\r\nKernel Debugger: Serial port not found!\r\n\r\n");
        return FALSE;
    }
    else
    {
#ifndef NDEBUG
        CHAR buffer[80];

        /* Print message to blue screen */
        sprintf(buffer,
                "\r\nKernel Debugger: Serial port found: COM%ld (Port 0x%p) BaudRate %ld\r\n\r\n",
                ComPortNumber,
                PortInformation->Address,
                PortInformation->BaudRate);
        HalDisplayString(buffer);
#endif /* NDEBUG */

#if 0
        /* Set global info */
        KdComPortInUse = DefaultPort.Address;
#endif
        return TRUE;
    }
}

KdPortPutByteEx()

VOID NTAPI KdPortPutByteEx	(	IN PCPPORT	PortInformation,
		IN UCHAR	ByteToSend
	)

Definition at line 139 of file kdbg.c.

{
    CpPutByte(PortInformation, ByteToSend);
}