pdevobj.h File Reference

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

Go to the source code of this file.

Classes
struct	_GDIPOINTER
struct	_DEVMODEINFO
struct	_DEVMODEENTRY
struct	_GRAPHICS_DEVICE
struct	_PDEVOBJ

Typedefs
typedef struct _GDIPOINTER	GDIPOINTER
typedef struct _GDIPOINTER *	PGDIPOINTER
typedef struct _DEVMODEINFO	DEVMODEINFO
typedef struct _DEVMODEINFO *	PDEVMODEINFO
typedef struct _DEVMODEENTRY	DEVMODEENTRY
typedef struct _DEVMODEENTRY *	PDEVMODEENTRY
typedef struct _GRAPHICS_DEVICE	GRAPHICS_DEVICE
typedef struct _GRAPHICS_DEVICE *	PGRAPHICS_DEVICE
typedef struct _PDEVOBJ	PDEVOBJ
typedef struct _PDEVOBJ *	PPDEVOBJ

Enumerations
enum	_PDEVFLAGS {   PDEV_DISPLAY = 0x00000001, PDEV_HARDWARE_POINTER = 0x00000002, PDEV_SOFTWARE_POINTER = 0x00000004, PDEV_GOTFONTS = 0x00000040,   PDEV_PRINTER = 0x00000080, PDEV_ALLOCATEDBRUSHES = 0x00000100, PDEV_HTPAL_IS_DEVPAL = 0x00000200, PDEV_DISABLED = 0x00000400,   PDEV_SYNCHRONIZE_ENABLED = 0x00000800, PDEV_FONTDRIVER = 0x00002000, PDEV_GAMMARAMP_TABLE = 0x00004000, PDEV_UMPD = 0x00008000,   PDEV_SHARED_DEVLOCK = 0x00010000, PDEV_META_DEVICE = 0x00020000, PDEV_DRIVER_PUNTED_CALL = 0x00040000, PDEV_CLONE_DEVICE = 0x00080000 }

Functions
PPDEVOBJ NTAPI	EngpGetPDEV (_In_opt_ PUNICODE_STRING pustrDevice)
FORCEINLINE VOID	PDEVOBJ_vReference (_In_ PPDEVOBJ ppdev)
VOID NTAPI	PDEVOBJ_vRelease (_Inout_ PPDEVOBJ ppdev)
PSURFACE NTAPI	PDEVOBJ_pSurface (_In_ PPDEVOBJ ppdev)
VOID NTAPI	PDEVOBJ_vGetDeviceCaps (_In_ PPDEVOBJ ppdev, _Out_ PDEVCAPS pDevCaps)
INIT_FUNCTION NTSTATUS NTAPI	InitPDEVImpl (VOID)
PSIZEL FASTCALL	PDEVOBJ_sizl (_In_ PPDEVOBJ ppdev, _Out_ PSIZEL psizl)
BOOL NTAPI	PDEVOBJ_bSwitchMode (PPDEVOBJ ppdev, PDEVMODEW pdm)
PDEVMODEW NTAPI	PDEVOBJ_pdmMatchDevMode (PPDEVOBJ ppdev, PDEVMODEW pdm)

Variables
PPDEVOBJ	gppdevPrimary

Typedef Documentation

DEVMODEENTRY

typedef struct _DEVMODEENTRY DEVMODEENTRY

DEVMODEINFO

typedef struct _DEVMODEINFO DEVMODEINFO

GDIPOINTER

typedef struct _GDIPOINTER GDIPOINTER

GRAPHICS_DEVICE

typedef struct _GRAPHICS_DEVICE GRAPHICS_DEVICE

PDEVMODEENTRY

typedef struct _DEVMODEENTRY * PDEVMODEENTRY

PDEVMODEINFO

typedef struct _DEVMODEINFO * PDEVMODEINFO

PDEVOBJ

typedef struct _PDEVOBJ PDEVOBJ

PGDIPOINTER

typedef struct _GDIPOINTER * PGDIPOINTER

PGRAPHICS_DEVICE

typedef struct _GRAPHICS_DEVICE * PGRAPHICS_DEVICE

PPDEVOBJ

typedef struct _PDEVOBJ * PPDEVOBJ

Enumeration Type Documentation

_PDEVFLAGS

enum _PDEVFLAGS

Enumerator
PDEV_DISPLAY
PDEV_HARDWARE_POINTER
PDEV_SOFTWARE_POINTER
PDEV_GOTFONTS
PDEV_PRINTER
PDEV_ALLOCATEDBRUSHES
PDEV_HTPAL_IS_DEVPAL
PDEV_DISABLED
PDEV_SYNCHRONIZE_ENABLED
PDEV_FONTDRIVER
PDEV_GAMMARAMP_TABLE
PDEV_UMPD
PDEV_SHARED_DEVLOCK
PDEV_META_DEVICE
PDEV_DRIVER_PUNTED_CALL
PDEV_CLONE_DEVICE

Definition at line 5 of file pdevobj.h.

{
    PDEV_DISPLAY             = 0x00000001, /* Display device */
    PDEV_HARDWARE_POINTER    = 0x00000002, /* Supports hardware cursor */
    PDEV_SOFTWARE_POINTER    = 0x00000004,
    PDEV_GOTFONTS            = 0x00000040, /* Has font driver */
    PDEV_PRINTER             = 0x00000080,
    PDEV_ALLOCATEDBRUSHES    = 0x00000100,
    PDEV_HTPAL_IS_DEVPAL     = 0x00000200,
    PDEV_DISABLED            = 0x00000400,
    PDEV_SYNCHRONIZE_ENABLED = 0x00000800,
    PDEV_FONTDRIVER          = 0x00002000, /* Font device */
    PDEV_GAMMARAMP_TABLE     = 0x00004000,
    PDEV_UMPD                = 0x00008000,
    PDEV_SHARED_DEVLOCK      = 0x00010000,
    PDEV_META_DEVICE         = 0x00020000,
    PDEV_DRIVER_PUNTED_CALL  = 0x00040000, /* Driver calls back to GDI engine */
    PDEV_CLONE_DEVICE        = 0x00080000
};

Function Documentation

EngpGetPDEV()

PPDEVOBJ NTAPI EngpGetPDEV

(

_In_opt_ PUNICODE_STRING

pustrDevice

)

Definition at line 595 of file pdevobj.c.

{
    UNICODE_STRING ustrCurrent;
    PPDEVOBJ ppdev;
    PGRAPHICS_DEVICE pGraphicsDevice;

    /* Acquire PDEV lock */
    EngAcquireSemaphore(ghsemPDEV);

    /* Did the caller pass a device name? */
    if (pustrDeviceName)
    {
        /* Loop all present PDEVs */
        for (ppdev = gppdevList; ppdev; ppdev = ppdev->ppdevNext)
        {
            /* Get a pointer to the GRAPHICS_DEVICE */
            pGraphicsDevice = ppdev->pGraphicsDevice;

            /* Compare the name */
            RtlInitUnicodeString(&ustrCurrent, pGraphicsDevice->szWinDeviceName);
            if (RtlEqualUnicodeString(pustrDeviceName, &ustrCurrent, FALSE))
            {
                /* Found! */
                break;
            }
        }
    }
    else
    {
        /* Otherwise use the primary PDEV */
        ppdev = gppdevPrimary;
    }

    /* Did we find one? */
    if (ppdev)
    {
        /* Yes, reference the PDEV */
        PDEVOBJ_vReference(ppdev);
    }
    else
    {
        /* No, create a new PDEV for the given device */
        ppdev = EngpCreatePDEV(pustrDeviceName, NULL);
        if (ppdev)
        {
            /* Insert the PDEV into the list */
            ppdev->ppdevNext = gppdevList;
            gppdevList = ppdev;

            /* Set as primary PDEV, if we don't have one yet */
            if (!gppdevPrimary)
            {
                gppdevPrimary = ppdev;
                ppdev->pGraphicsDevice->StateFlags |= DISPLAY_DEVICE_PRIMARY_DEVICE;
            }
        }
    }

    /* Release PDEV lock */
    EngReleaseSemaphore(ghsemPDEV);

    return ppdev;
}

Referenced by GreCreateCompatibleDC(), GreOpenDCW(), NtGdiExtEscape(), UserChangeDisplaySettings(), UserEnumCurrentDisplaySettings(), and UserEnumDisplaySettings().

InitPDEVImpl()

INIT_FUNCTION NTSTATUS NTAPI InitPDEVImpl

(

VOID

)

Definition at line 21 of file pdevobj.c.

{
    ghsemPDEV = EngCreateSemaphore();
    if (!ghsemPDEV) return STATUS_INSUFFICIENT_RESOURCES;
    return STATUS_SUCCESS;
}

Referenced by DriverEntry().

PDEVOBJ_bSwitchMode()

BOOL NTAPI PDEVOBJ_bSwitchMode	(	PPDEVOBJ	ppdev,
		PDEVMODEW	pdm
	)

Definition at line 509 of file pdevobj.c.

{
    UNICODE_STRING ustrDevice;
    PPDEVOBJ ppdevTmp;
    PSURFACE pSurface;
    BOOL retval = FALSE;

    /* Lock the PDEV */
    EngAcquireSemaphore(ppdev->hsemDevLock);

    /* And everything else */
    EngAcquireSemaphore(ghsemPDEV);

    DPRINT1("PDEVOBJ_bSwitchMode, ppdev = %p, pSurface = %p\n", ppdev, ppdev->pSurface);

    // Lookup the GraphicsDevice + select DEVMODE
    // pdm = PDEVOBJ_pdmMatchDevMode(ppdev, pdm);

    /* 1. Temporarily disable the current PDEV and reset video to its default mode */
    if (!ppdev->pfn.AssertMode(ppdev->dhpdev, FALSE))
    {
        DPRINT1("DrvAssertMode(FALSE) failed\n");
        goto leave;
    }

    /* 2. Create new PDEV */
    RtlInitUnicodeString(&ustrDevice, ppdev->pGraphicsDevice->szWinDeviceName);
    ppdevTmp = EngpCreatePDEV(&ustrDevice, pdm);
    if (!ppdevTmp)
    {
        DPRINT1("Failed to create a new PDEV\n");
        goto leave2;
    }

    /* 3. Create a new surface */
    pSurface = PDEVOBJ_pSurface(ppdevTmp);
    if (!pSurface)
    {
        DPRINT1("PDEVOBJ_pSurface failed\n");
        PDEVOBJ_vRelease(ppdevTmp);
        goto leave2;
    }

    /* 4. Get DirectDraw information */
    /* 5. Enable DirectDraw Not traced */
    /* 6. Copy old PDEV state to new PDEV instance */

    /* 7. Switch the PDEVs */
    PDEVOBJ_vSwitchPdev(ppdev, ppdevTmp);

    /* 8. Disable DirectDraw */

    PDEVOBJ_vRelease(ppdevTmp);

    /* Update primary display capabilities */
    if (ppdev == gppdevPrimary)
    {
        PDEVOBJ_vGetDeviceCaps(ppdev, &GdiHandleTable->DevCaps);
    }

    /* Success! */
    retval = TRUE;

leave2:
    /* Set the new video mode, or restore the original one in case of failure */
    if (!ppdev->pfn.AssertMode(ppdev->dhpdev, TRUE))
    {
        DPRINT1("DrvAssertMode(TRUE) failed\n");
    }

leave:
    /* Unlock everything else */
    EngReleaseSemaphore(ghsemPDEV);
    /* Unlock the PDEV */
    EngReleaseSemaphore(ppdev->hsemDevLock);

    DPRINT1("leave, ppdev = %p, pSurface = %p\n", ppdev, ppdev->pSurface);

    return retval;
}

Referenced by UserChangeDisplaySettings(), and UserRefreshDisplay().

PDEVOBJ_pdmMatchDevMode()

PDEVMODEW NTAPI PDEVOBJ_pdmMatchDevMode	(	PPDEVOBJ	ppdev,
		PDEVMODEW	pdm
	)

Definition at line 307 of file pdevobj.c.

{
    PGRAPHICS_DEVICE pGraphicsDevice;
    PDEVMODEW pdmCurrent;
    ULONG i;
    DWORD dwFields;

    pGraphicsDevice = ppdev->pGraphicsDevice;

    for (i = 0; i < pGraphicsDevice->cDevModes; i++)
    {
        pdmCurrent = pGraphicsDevice->pDevModeList[i].pdm;

        /* Compare asked DEVMODE fields
         * Only compare those that are valid in both DEVMODE structs */
        dwFields = pdmCurrent->dmFields & pdm->dmFields;

        /* For now, we only need those */
        if ((dwFields & DM_BITSPERPEL) &&
            (pdmCurrent->dmBitsPerPel != pdm->dmBitsPerPel)) continue;
        if ((dwFields & DM_PELSWIDTH) &&
            (pdmCurrent->dmPelsWidth != pdm->dmPelsWidth)) continue;
        if ((dwFields & DM_PELSHEIGHT) &&
            (pdmCurrent->dmPelsHeight != pdm->dmPelsHeight)) continue;
        if ((dwFields & DM_DISPLAYFREQUENCY) &&
            (pdmCurrent->dmDisplayFrequency != pdm->dmDisplayFrequency)) continue;

        /* Match! Return the DEVMODE */
        return pdmCurrent;
    }

    /* Nothing found */
    return NULL;
}

Referenced by EngpCreatePDEV(), PDEVOBJ_vRefreshModeList(), and UserChangeDisplaySettings().

PDEVOBJ_pSurface()

PSURFACE NTAPI PDEVOBJ_pSurface

(

_In_ PPDEVOBJ

ppdev

)

PDEVOBJ_sizl()

PSIZEL FASTCALL PDEVOBJ_sizl	(	_In_ PPDEVOBJ	ppdev,
		_Out_ PSIZEL	psizl
	)

PDEVOBJ_vGetDeviceCaps()

VOID NTAPI PDEVOBJ_vGetDeviceCaps	(	_In_ PPDEVOBJ	ppdev,
		_Out_ PDEVCAPS	pDevCaps
	)

PDEVOBJ_vReference()

FORCEINLINE VOID PDEVOBJ_vReference

(

_In_ PPDEVOBJ

ppdev

)

Definition at line 167 of file pdevobj.h.

{
    ASSERT(ppdev);

    /* Fail if the PDEV is being destroyed */
    if (ppdev->cPdevRefs == 0)
    {
        ASSERT(FALSE);
        return;
    }
    ASSERT(ppdev->cPdevRefs > 0);

    InterlockedIncrement(&ppdev->cPdevRefs);
}

Referenced by EngpGetPDEV(), GreCreateCompatibleDC(), NtGdiExtEscape(), NtGdiSaveDC(), and UserRefreshDisplay().

PDEVOBJ_vRelease()

VOID NTAPI PDEVOBJ_vRelease

(

_Inout_ PPDEVOBJ

ppdev

)

Definition at line 93 of file pdevobj.c.

{
    /* Lock loader */
    EngAcquireSemaphore(ghsemPDEV);

    /* Decrease reference count */
    InterlockedDecrement(&ppdev->cPdevRefs);
    ASSERT(ppdev->cPdevRefs >= 0);

    /* Check if references are left */
    if (ppdev->cPdevRefs == 0)
    {
        /* Do we have a surface? */
        if (ppdev->pSurface)
        {
            /* Release the surface and let the driver free it */
            SURFACE_ShareUnlockSurface(ppdev->pSurface);
            ppdev->pfn.DisableSurface(ppdev->dhpdev);
        }

        /* Do we have a palette? */
        if (ppdev->ppalSurf)
        {
            PALETTE_ShareUnlockPalette(ppdev->ppalSurf);
        }

        /* Check if the PDEV was enabled */
        if (ppdev->dhpdev != NULL)
        {
            /* Disable the PDEV */
            ppdev->pfn.DisablePDEV(ppdev->dhpdev);
        }

        /* Remove it from list */
        if (ppdev == gppdevList)
        {
            gppdevList = ppdev->ppdevNext;
        }
        else
        {
            PPDEVOBJ ppdevCurrent = gppdevList;
            BOOL found = FALSE;
            while (!found && ppdevCurrent->ppdevNext)
            {
                if (ppdevCurrent->ppdevNext == ppdev)
                    found = TRUE;
                else
                    ppdevCurrent = ppdevCurrent->ppdevNext;
            }
            if (found)
                ppdevCurrent->ppdevNext = ppdev->ppdevNext;
        }

        /* Is this the primary one ? */
        if (ppdev == gppdevPrimary)
            gppdevPrimary = NULL;

        /* Free it */
        PDEVOBJ_vDeletePDEV(ppdev);
    }

    /* Unlock loader */
    EngReleaseSemaphore(ghsemPDEV);
}

Referenced by DC_vCleanup(), EngpCreatePDEV(), GreCreateCompatibleDC(), GreOpenDCW(), NtGdiExtEscape(), PDEVOBJ_bSwitchMode(), UserChangeDisplaySettings(), UserEnumCurrentDisplaySettings(), UserEnumDisplaySettings(), and UserRefreshDisplay().

Variable Documentation

gppdevPrimary

PPDEVOBJ gppdevPrimary

Definition at line 13 of file pdevobj.c.

Referenced by co_IntInitializeDesktopGraphics(), DC_vInitDc(), EBRUSHOBJ_bRealizeBrush(), EBRUSHOBJ_psoMask(), EngpGetPDEV(), InitMetrics(), IntCreatePrimarySurface(), IntEnumHDev(), PDEVOBJ_bSwitchMode(), PDEVOBJ_vRelease(), and VideoPortCallout().