Share via

DDRAWI_DIRECTDRAW_GBL (Compact 2013)

  • Article

3/26/2014

This structure contains the global DirectDraw data that can be shared between object instances.

Syntax

typedef struct _DDRAWI_DIRECTDRAW_GBL {
  wchar_t DeviceName[DD_DEVICE_ENUM_NAME_LENGTH];
  DWORD ProcessFlags;
  Driver_t* Device;
  DDHAL_DDCALLBACKS DDCallbacks;
  DDHAL_DDSURFACECALLBACKS DDSurfaceCallbacks;
  DDHAL_DDPALETTECALLBACKS DDPaletteCallbacks;
  LPDDHAL_GETDRIVERINFO GetDriverInfo;
  DDHAL_DDMISCELLANEOUSCALLBACKS DDMiscCallbacks;
  DDHAL_DDCOLORCONTROLCALLBACKS DDColorCallbacks;
  DDCAPS ddCaps;
  DDCAPS ddHelCaps;
  LPDWORD lpdwFourCC;
  LPDDRAWI_DDRAWSURFACE_LCL pSurfaceList;
  LPDDRAWI_DDRAWCOLORCONTROL_LCL pColorControlList;
  LPDDRAWI_DDRAWGAMMACONTROL_LCL pGammaControlList;
  LPDDRAWI_DDRAWSURFACE_LCL *pOverlays;
  RECT *rcOverlayDest;
  DWORD dwGDISurfReserved1;
} DDRAWI_DIRECTDRAW_GBL;

Members

  • DeviceName[DD_DEVICE_ENUM_NAME_LENGTH]
    This member is used by DirectDraw and should not be filled in by the driver.

  • ProcessFlags
    Contains the DirectDraw object's control flags.

    The following table shows the possible flags.

    Flag

    Description

    DDRAWI_ATTACHEDTODESKTOP

    Reserved.

    DDRAWI_CHANGINGMODE

    Reserved.

    DDRAWI_DDRAWDATANOTFETCHED

    Reserved.

    DDRAWI_DISPLAYDRV

    Indicates the driver is the display driver.

    DDRAWI_EMULATIONINITIALIZED

    Used by DirectDraw and should not be set by the driver.

    DDRAWI_EXTENDEDALIGNMENT

    Used by DirectDraw and should not be set by the driver.

    DDRAWI_FLIPEDTOGDI

    Indicates the driver has been flipped to show the GDI surface.

    DDRAWI_FULLSCREEN

    Indicates the driver is in full-screen mode.

    DDRAWI_GDIDRV

    Reserved.

    DDRAWI_HASCKEYDESTOVERLAY

    Used by DirectDraw and should not be set by the driver.

    DDRAWI_HASCKEYSRCOVERLAY

    Used by DirectDraw and should not be set by the driver.

    DDRAWI_HASGDIPALETTE

    Used by DirectDraw and should not be set by the driver.

    DDRAWI_HASGDIPALETTE_EXCLUSIVE

    Reserved for future use.

    DDRAWI_MODECHANGED

    Used by DirectDraw and should not be set by the driver.

    DDRAWI_MODEX

    Used by DirectDraw and should not be set by the driver.

    DDRAWI_MODEXILLEGAL

    Indicates that ModeX is not supported by this hardware.

    DDRAWI_NEEDSWIN16FORVRAMLOCK

    Used by DirectDraw and should not be set by the driver.

    DDRAWI_NOEMULATION

    Used by DirectDraw and should not be set by the driver.

    DDRAWI_NOHARDWARE

    Used by DirectDraw and should not be set by the driver.

    DDRAWI_PALETTEINIT

    Used by DirectDraw and should not be set by the driver.

    DDRAWI_PDEVICEVRAMBITCLEARED

    Used by DirectDraw and should not be set by the driver.

    DDRAWI_SECONDARYDRIVERLOADED

    Used by DirectDraw and should not be set by the driver.

    DDRAWI_STANDARDVGA

    Used by DirectDraw and should not be set by the driver.

    DDRAWI_UMODELOADED

    Reserved.

    DDRAWI_VIRTUALDESKTOP

    Used by DirectDraw and should not be set by the driver.
  • Device
    This member is used by DirectDraw and should not be filled in by the driver.
  • DDCallbacks
    This member is used by DirectDraw and should not be filled in by the driver.
  • DDSurfaceCallbacks
    This member is used by DirectDraw and should not be filled in by the driver.
  • DDPaletteCallbacks
    This member is used by DirectDraw and should not be filled in by the driver.
  • GetDriverInfo
    This member is used by DirectDraw and should not be filled in by the driver.
  • DDMiscCallbacks
    This member is used by DirectDraw and should not be filled in by the driver.
  • DDColorCallbacks
    This member is used by DirectDraw and should not be filled in by the driver.
  • ddCaps
    Pointer to a DDCAPS structure that contains the driver's hardware capabilities.
  • ddHelCaps
    Pointer to a DDCAPS structure that contains the driver's software emulated capabilities.
  • lpdwFourCC
    This member is used by DirectDraw and should not be filled in by the driver.
  • pSurfaceList
    This member is used by DirectDraw and should not be filled in by the driver.
  • pColorControlList
    This member is used by DirectDraw and should not be filled in by the driver.
  • pGammaControlList
    This member is used by DirectDraw and should not be filled in by the driver.

  • pOverlays
    This member is used by DirectDraw and should not be filled in by the driver.

    Note

    This member is a pointer to an array of 32 LPDDRAWI_DDRAWSURFACE_LCL elements that are arranged in front-to-back order. The surface pointer that represents the top overlay is at index 0, and the overlay that is closest to the primary surface, the bottom overlay, is at index n-1, where n is the number of overlays created on the device. Elements [n...31] are NULL.
    DirectDraw modifies the order of the pOverlays array and then calls UpdateOverlay on the driver. To determine whether the overlay z-order of a display driver compliant with the DirectDraw Hardware Abstraction Layer (DDHAL) should be updated, compare pOverlays against a previously cached copy to see if the order changed.

  • rcOverlayDest
    This member is used by DirectDraw and should not be filled in by the driver.
  • dwGDISurfReserved1
    This member is used by DirectDraw and should not be filled in by the driver.

Requirements

Header

ddrawi.h

See Also

Reference

DirectDraw Display Driver Structures