inbv.h File Reference

#include "bootvid/bootvid.h"

Include dependency graph for inbv.h:

Go to the source code of this file.

Functions
BOOLEAN NTAPI	InbvDriverInitialize (_In_ PLOADER_PARAMETER_BLOCK LoaderBlock, _In_ ULONG Count)
INBV_DISPLAY_STATE NTAPI	InbvGetDisplayState (VOID)
VOID NTAPI	InbvAcquireLock (VOID)
VOID NTAPI	InbvReleaseLock (VOID)
PUCHAR NTAPI	InbvGetResourceAddress (_In_ ULONG ResourceNumber)
VOID NTAPI	InbvBitBlt (_In_ PUCHAR Buffer, _In_ ULONG X, _In_ ULONG Y)
VOID NTAPI	InbvBufferToScreenBlt (_In_reads_bytes_(Delta *Height) PUCHAR Buffer, _In_ ULONG X, _In_ ULONG Y, _In_ ULONG Width, _In_ ULONG Height, _In_ ULONG Delta)
VOID NTAPI	InbvScreenToBufferBlt (_Out_writes_bytes_all_(Delta *Height) PUCHAR Buffer, _In_ ULONG X, _In_ ULONG Y, _In_ ULONG Width, _In_ ULONG Height, _In_ ULONG Delta)
VOID NTAPI	InbvSetProgressBarCoordinates (_In_ ULONG Left, _In_ ULONG Top)
	Sets the screen coordinates of the loading progress bar and enable it.
VOID NTAPI	InbvIndicateProgress (VOID)
	Gives some progress feedback, without specifying any explicit number of progress steps or percentage. The corresponding percentage is derived from the progress indicator's current count, capped to the number of expected calls to be made to this function (default: 25, see InbvProgressIndicator.Expected).
VOID NTAPI	InbvSetProgressBarSubset (_In_ ULONG Floor, _In_ ULONG Ceiling)
	Specifies a progress percentage sub-range. Further calls to InbvIndicateProgress() or InbvUpdateProgressBar() will update the progress percentage relative to this sub-range. In particular, the percentage provided to InbvUpdateProgressBar() is relative to this sub-range.
VOID NTAPI	InbvUpdateProgressBar (_In_ ULONG Percentage)
	Updates the progress bar percentage, relative to the current percentage sub-range previously set by InbvSetProgressBarSubset().
VOID NTAPI	InbvPortEnableFifo (_In_ ULONG PortId, _In_ BOOLEAN Enable)
BOOLEAN NTAPI	InbvPortPollOnly (_In_ ULONG PortId)
BOOLEAN NTAPI	InbvPortGetByte (_In_ ULONG PortId, _Out_ PUCHAR Byte)
VOID NTAPI	InbvPortPutByte (_In_ ULONG PortId, _In_ UCHAR Byte)
BOOLEAN NTAPI	InbvPortInitialize (_In_ ULONG BaudRate, _In_ ULONG PortNumber, _In_ PUCHAR PortAddress, _Out_ PULONG PortId, _In_ BOOLEAN IsMMIODevice)
VOID NTAPI	InbvPortTerminate (_In_ ULONG PortId)

Variables
BOOLEAN	InbvBootDriverInstalled

Function Documentation

InbvAcquireLock()

VOID NTAPI InbvAcquireLock

(

VOID

)

Definition at line 223 of file inbv.c.

{
    KIRQL OldIrql;
 
    /* Check if we're at dispatch level or lower */
    OldIrql = KeGetCurrentIrql();
    if (OldIrql <= DISPATCH_LEVEL)
    {
        /* Loop until the lock is free */
        while (!KeTestSpinLock(&BootDriverLock));
 
        /* Raise IRQL to dispatch level */
        KeRaiseIrql(DISPATCH_LEVEL, &OldIrql);
    }
 
    /* Acquire the lock */
    KiAcquireSpinLock(&BootDriverLock);
    InbvOldIrql = OldIrql;
}

Referenced by BootAnimTickProgressBar(), BootLogoFadeIn(), DisplayBootBitmap(), FinalizeBootLogo(), InbvBitBlt(), InbvDisplayString(), InbvEnableBootDriver(), InbvNotifyDisplayOwnershipLost(), InbvRotationThread(), and InbvSolidColorFill().

InbvBitBlt()

VOID NTAPI InbvBitBlt	(	_In_ PUCHAR	Buffer,
		_In_ ULONG	X,
		_In_ ULONG	Y
	)

Definition at line 537 of file inbv.c.

{
    /* Check if we're installed and we own it */
    if (InbvBootDriverInstalled &&
        (InbvDisplayState == INBV_DISPLAY_STATE_OWNED))
    {
        /* Acquire the lock */
        InbvAcquireLock();
 
        /* Do the blit */
        VidBitBlt(Buffer, X, Y);
 
        /* Release the lock */
        InbvReleaseLock();
    }
}

Referenced by BitBltPalette(), and DisplayShutdownBitmap().

InbvBufferToScreenBlt()

VOID NTAPI InbvBufferToScreenBlt	(	_In_reads_bytes_(Delta *Height) PUCHAR	Buffer,
		_In_ ULONG	X,
		_In_ ULONG	Y,
		_In_ ULONG	Width,
		_In_ ULONG	Height,
		_In_ ULONG	Delta
	)

Definition at line 559 of file inbv.c.

{
    /* Check if we're installed and we own it */
    if (InbvBootDriverInstalled &&
        (InbvDisplayState == INBV_DISPLAY_STATE_OWNED))
    {
        /* Do the blit */
        VidBufferToScreenBlt(Buffer, X, Y, Width, Height, Delta);
    }
}

Referenced by DisplayBootBitmap().

InbvDriverInitialize()

BOOLEAN NTAPI InbvDriverInitialize	(	_In_ PLOADER_PARAMETER_BLOCK	LoaderBlock,
		_In_ ULONG	Count
	)

Definition at line 179 of file inbv.c.

{
    PCHAR CommandLine;
    BOOLEAN ResetMode = FALSE; // By default do not reset the video mode
    ULONG i;
 
    /* Quit if we're already installed */
    if (InbvBootDriverInstalled) return TRUE;
 
    /* Initialize the lock and check the current display state */
    KeInitializeSpinLock(&BootDriverLock);
    if (InbvDisplayState == INBV_DISPLAY_STATE_OWNED)
    {
        /* Reset the video mode in case we do not have a custom boot logo */
        CommandLine = (LoaderBlock->LoadOptions ? _strupr(LoaderBlock->LoadOptions) : NULL);
        ResetMode   = (CommandLine == NULL) || (strstr(CommandLine, "BOOTLOGO") == NULL);
    }
 
    /* Initialize the video */
    InbvBootDriverInstalled = VidInitialize(ResetMode);
    if (InbvBootDriverInstalled)
    {
        /* Find bitmap resources in the kernel */
        ResourceCount = min(Count, RTL_NUMBER_OF(ResourceList) - 1);
        for (i = 1; i <= ResourceCount; i++)
        {
            /* Do the lookup */
            ResourceList[i] = FindBitmapResource(LoaderBlock, i);
        }
 
        /* Set the progress bar ranges */
        InbvSetProgressBarSubset(0, 100);
 
        // BootAnimInitialize(LoaderBlock, Count);
    }
 
    /* Return install state */
    return InbvBootDriverInstalled;
}

Referenced by Phase1InitializationDiscard().

InbvGetDisplayState()

INBV_DISPLAY_STATE NTAPI InbvGetDisplayState

(

VOID

)

Definition at line 327 of file inbv.c.

{
    /* Return the actual state */
    return InbvDisplayState;
}

Referenced by BootAnimTickProgressBar(), BootLogoFadeIn(), FinalizeBootLogo(), and InbvRotationThread().

InbvGetResourceAddress()

PUCHAR NTAPI InbvGetResourceAddress

(

_In_ ULONG

ResourceNumber

)

Definition at line 166 of file inbv.c.

{
    /* Validate the resource number */
    if (ResourceNumber > ResourceCount) return NULL;
 
    /* Return the address */
    return ResourceList[ResourceNumber];
}

Referenced by DisplayBootBitmap(), and DisplayShutdownBitmap().

InbvIndicateProgress()

VOID NTAPI InbvIndicateProgress

(

VOID

)

Gives some progress feedback, without specifying any explicit number of progress steps or percentage. The corresponding percentage is derived from the progress indicator's current count, capped to the number of expected calls to be made to this function (default: 25, see InbvProgressIndicator.Expected).

Returns

None.

Definition at line 632 of file inbv.c.

{
    ULONG Percentage;
 
    /* Increase progress */
    InbvProgressIndicator.Count++;
 
    /* Compute the new percentage - Don't go over 100% */
    Percentage = 100 * InbvProgressIndicator.Count /
                       InbvProgressIndicator.Expected;
    Percentage = min(Percentage, 99);
 
    if (Percentage != InbvProgressIndicator.Percentage)
    {
        /* Percentage has changed, update the progress bar */
        InbvProgressIndicator.Percentage = Percentage;
        InbvUpdateProgressBar(Percentage);
    }
}

Referenced by IopInitializeBuiltinDriver(), and IopInitializeSystemDrivers().

InbvPortEnableFifo()

VOID NTAPI InbvPortEnableFifo	(	_In_ ULONG	PortId,
		_In_ BOOLEAN	Enable
	)

Definition at line 60 of file inbvport.c.

{
    /* Set FIFO as requested */
    CpEnableFifo(Port[PortId].Address, Enable);
}

Referenced by HdlspEnableTerminal().

InbvPortGetByte()

BOOLEAN NTAPI InbvPortGetByte	(	_In_ ULONG	PortId,
		_Out_ PUCHAR	Byte
	)

Definition at line 40 of file inbvport.c.

{
    /* Read a byte from the port */
    return CpGetByte(&Port[PortId], Byte, TRUE, FALSE) == CP_GET_SUCCESS;
}

Referenced by HdlspDispatch().

InbvPortInitialize()

BOOLEAN NTAPI InbvPortInitialize	(	_In_ ULONG	BaudRate,
		_In_ ULONG	PortNumber,
		_In_ PUCHAR	PortAddress,
		_Out_ PULONG	PortId,
		_In_ BOOLEAN	IsMMIODevice
	)

Definition at line 79 of file inbvport.c.

{
    /* Not yet supported */
    ASSERT(IsMMIODevice == FALSE);
 
    /* Set the default baud rate */
    if (BaudRate == 0)
        BaudRate = DEFAULT_BAUD_RATE;
 
    /* Check if the port or address is given */
    if (PortNumber)
    {
        /* Pick correct address for port */
        if (!PortAddress)
        {
            if (PortNumber < 1 || PortNumber > MAX_COM_PORTS)
                PortNumber = MAX_COM_PORTS;
            PortAddress = UlongToPtr(BaseArray[PortNumber]);
        }
    }
    else
    {
        /* Pick correct port for address */
#if defined(SARCH_PC98)
        static const ULONG TestPorts[] = {1, 2};
#else
        static const ULONG TestPorts[] = {2, 1};
#endif
        PortAddress = UlongToPtr(BaseArray[TestPorts[0]]);
        if (CpDoesPortExist(PortAddress))
        {
            PortNumber = TestPorts[0];
        }
        else
        {
            PortAddress = UlongToPtr(BaseArray[TestPorts[1]]);
            if (!CpDoesPortExist(PortAddress))
                return FALSE;
            PortNumber = TestPorts[1];
        }
    }
 
    /* Initialize the port unless it's already up and return it */
    if (Port[PortNumber - 1].Address)
        return FALSE;
 
    CpInitialize(&Port[PortNumber - 1], PortAddress, BaudRate);
    *PortId = PortNumber - 1;
    return TRUE;
}

Referenced by HdlspEnableTerminal().

InbvPortPollOnly()

BOOLEAN NTAPI InbvPortPollOnly

(

_In_ ULONG

PortId

)

Definition at line 29 of file inbvport.c.

{
    UCHAR Dummy;
 
    /* Poll a byte from the port */
    return CpGetByte(&Port[PortId], &Dummy, FALSE, TRUE) == CP_GET_SUCCESS;
}

Referenced by HdlspDispatch().

InbvPortPutByte()

VOID NTAPI InbvPortPutByte	(	_In_ ULONG	PortId,
		_In_ UCHAR	Byte
	)

Definition at line 50 of file inbvport.c.

{
    /* Send the byte */
    CpPutByte(&Port[PortId], Byte);
}

Referenced by HdlspPutData(), and HdlspSendStringAtBaud().

InbvPortTerminate()

VOID NTAPI InbvPortTerminate

(

_In_ ULONG

PortId

)

Definition at line 70 of file inbvport.c.

{
    /* The port is now available */
    Port[PortId].Address = NULL;
}

Referenced by HdlspEnableTerminal().

InbvReleaseLock()

VOID NTAPI InbvReleaseLock

(

VOID

)

Definition at line 245 of file inbv.c.

{
    KIRQL OldIrql;
 
    /* Capture the old IRQL */
    OldIrql = InbvOldIrql;
 
    /* Release the driver lock */
    KiReleaseSpinLock(&BootDriverLock);
 
    /* If we were at dispatch level or lower, restore the old IRQL */
    if (InbvOldIrql <= DISPATCH_LEVEL) KeLowerIrql(OldIrql);
}

Referenced by BootAnimTickProgressBar(), BootLogoFadeIn(), DisplayBootBitmap(), FinalizeBootLogo(), InbvBitBlt(), InbvDisplayString(), InbvEnableBootDriver(), InbvNotifyDisplayOwnershipLost(), InbvRotationThread(), and InbvSolidColorFill().

InbvScreenToBufferBlt()

VOID NTAPI InbvScreenToBufferBlt	(	_Out_writes_bytes_all_(Delta *Height) PUCHAR	Buffer,
		_In_ ULONG	X,
		_In_ ULONG	Y,
		_In_ ULONG	Width,
		_In_ ULONG	Height,
		_In_ ULONG	Delta
	)

Definition at line 578 of file inbv.c.

{
    /* Check if we're installed and we own it */
    if (InbvBootDriverInstalled &&
        (InbvDisplayState == INBV_DISPLAY_STATE_OWNED))
    {
        /* Do the blit */
        VidScreenToBufferBlt(Buffer, X, Y, Width, Height, Delta);
    }
}

Referenced by DisplayBootBitmap().

InbvSetProgressBarCoordinates()

VOID NTAPI InbvSetProgressBarCoordinates	(	_In_ ULONG	Left,
		_In_ ULONG	Top
	)

Sets the screen coordinates of the loading progress bar and enable it.

Parameters

[in]	Left
[in]	Top	The left/top coordinates.

Returns

None.

Definition at line 607 of file inbv.c.

{
    /* Update the coordinates */
    ProgressBarLeft = Left;
    ProgressBarTop  = Top;
 
    /* Enable the progress bar */
    ShowProgressBar = TRUE;
}

Referenced by DisplayBootBitmap().

InbvSetProgressBarSubset()

VOID NTAPI InbvSetProgressBarSubset	(	_In_ ULONG	Floor,
		_In_ ULONG	Ceiling
	)

Specifies a progress percentage sub-range. Further calls to InbvIndicateProgress() or InbvUpdateProgressBar() will update the progress percentage relative to this sub-range. In particular, the percentage provided to InbvUpdateProgressBar() is relative to this sub-range.

Parameters

[in]	Floor	The lower bound percentage of the sub-range (default: 0).
[in]	Ceiling	The upper bound percentage of the sub-range (default: 100).

Returns

None.

Definition at line 670 of file inbv.c.

{
    /* Sanity checks */
    ASSERT(Floor < Ceiling);
    ASSERT(Ceiling <= 100);
 
    /* Update the progress bar state */
    InbvProgressState.Floor = Floor * 100;
    InbvProgressState.Ceiling = Ceiling * 100;
    InbvProgressState.Bias = Ceiling - Floor;
}

Referenced by BootAnimInitialize(), InbvDriverInitialize(), and Phase1InitializationDiscard().

InbvUpdateProgressBar()

VOID NTAPI InbvUpdateProgressBar

(

_In_ ULONG

Percentage

)

Updates the progress bar percentage, relative to the current percentage sub-range previously set by InbvSetProgressBarSubset().

Parameters

[in]

Percentage

The progress percentage, relative to the current sub-range.

Returns

None.

Definition at line 696 of file inbv.c.

{
    ULONG TotalProgress;
 
    /* Make sure the progress bar is enabled, that we own and are installed */
    if (ShowProgressBar &&
        InbvBootDriverInstalled &&
        (InbvDisplayState == INBV_DISPLAY_STATE_OWNED))
    {
        /* Compute the total progress and tick the progress bar */
        TotalProgress = InbvProgressState.Floor + (Percentage * InbvProgressState.Bias);
        // TotalProgress /= (100 * 100);
 
        BootAnimTickProgressBar(TotalProgress);
    }
}

Referenced by InbvIndicateProgress(), and Phase1InitializationDiscard().

Variable Documentation

InbvBootDriverInstalled

BOOLEAN InbvBootDriverInstalled

extern

Definition at line 39 of file inbv.c.

Referenced by BootAnimInitialize(), BootAnimTickProgressBar(), BootLogoFadeIn(), DisplayBootBitmap(), DisplayShutdownBitmap(), InbvBitBlt(), InbvBufferToScreenBlt(), InbvDisplayString(), InbvDriverInitialize(), InbvEnableBootDriver(), InbvIsBootDriverInstalled(), InbvNotifyDisplayOwnershipLost(), InbvResetDisplay(), InbvScreenToBufferBlt(), InbvSolidColorFill(), InbvUpdateProgressBar(), and Phase1InitializationDiscard().