Important:
This is retired content. This content is outdated and is no
longer being maintained. It is provided as a courtesy for
individuals who are still using these technologies. This content
may contain URLs that were valid when originally published, but now
link to sites or pages that no longer exist.
The
DDRAWI_DIRECTDRAW_GBL structure contains the global
DirectDraw data that can be shared between object instances.
typedef struct _DDRAWI_DIRECTDRAW_GBL { DWORD
dwRefCnt
;
DWORD
dwFlags
;
FLATPTR
fpPrimaryOrig
;
DDCORECAPS
ddCaps
;
DWORD
dwInternal1
;
DWORD
dwUnused1[9]
;
LPDDHAL_CALLBACKS
lpDDCBtmp
;
LPDDRAWI_DDRAWSURFACE_INT
dsList
;
LPDDRAWI_DDRAWPALETTE_INT
palList
;
LPDDRAWI_DDRAWCLIPPER_INT
clipperList
;
LPDDRAWI_DIRECTDRAW_GBL
lp16DD
;
DWORD
dwMaxOverlays
;
DWORD
dwCurrOverlays
;
DWORD
dwMonitorFrequency
;
DDCORECAPS
ddHELCaps
;
DWORD
dwUnused2[50]
;
DDCOLORKEY
ddckCKDestOverlay
;
DDCOLORKEY
ddckCKSrcOverlay
;
VIDMEMINFO
vmiData
;
LPVOID
lpDriverHandle
;
LPDDRAWI_DIRECTDRAW_LCL
lpExclusiveOwner
;
DWORD
dwModeIndex
;
DWORD
dwModeIndexOrig
;
DWORD
dwNumFourCC
;
DWORD
FAR *
lpdwFourCC
;
DWORD
dwNumModes
;
LPDDHALMODEINFO
lpModeInfo
;
PROCESS_LIST
plProcessList
;
DWORD
dwSurfaceLockCount
;
DWORD
dwAliasedLockCnt
;
ULONG_PTR
dwReserved3
;
ULONG_PTR
hDD
;
wchar_t
cObsolete[12]
;
DWORD
dwReserved1
;
DWORD
dwReserved2
;
DBLNODE
dbnOverlayRoot
;
volatile LPWORD
lpwPDeviceFlags
;
DWORD
dwPDevice
;
DWORD
dwWin16LockCnt
;
DWORD
dwUnused3
;
DWORD
hInstance
;
DWORD
dwEvent16
;
DWORD
dwSaveNumModes
;
ULONG_PTR
lpD3DGlobalDriverData
;
ULONG_PTR
lpD3DHALCallbacks
;
DDCORECAPS
ddBothCaps
;
LPDDVIDEOPORTCAPS
lpDDVideoPortCaps
;
LPDDRAWI_DDVIDEOPORT_INT
dvpList
;
ULONG_PTR
lpD3DHALCallbacks2
;
RECT
rectDevice
;
DWORD
cMonitors
;
LPVOID
gpbmiSrc
;
LPVOID
gpbmiDest
;
LPHEAPALIASINFO
phaiHeapAliases
;
DWORD
hKernelHandle
;
ULONG_PTR
pfnNotifyProc
;
LPDDKERNELCAPS
lpDDKernelCaps
;
LPDDNONLOCALVIDMEMCAPS
lpddNLVCaps
;
LPDDNONLOCALVIDMEMCAPS
lpddNLVHELCaps
;
LPDDNONLOCALVIDMEMCAPS
lpddNLVBothCaps
;
ULONG_PTR
lpD3DExtendedCaps
;
DWORD
dwDOSBoxEvent
;
RECT
rectDesktop
;
wchar_t
cDriverName[MAX_DRIVER_NAME]
;
ULONG_PTR
lpD3DHALCallbacks3
;
DWORD
dwNumZPixelFormats
;
LPDDPIXELFORMAT
lpZPixelFormats
;
ULONG_PTR
mcList
;
DWORD
hDSVxd
;
DDSCAPSEX
ddsCapsMore
;
} DDRAWI_DIRECTDRAW_GBL;
Members
dwRefCnt
This member is used by DirectDraw and should not be filled in
by the driver.
dwFlags
Contains the DirectDraw object's control flags.
Flag
Usage
DDRAWI_ATTACHEDTODESKTOP
Reserved for future use.
DDRAWI_CHANGINGMODE
Reserved for future use.
DDRAWI_DDRAWDATANOTFETCHED
Reserved for future use.
DDRAWI_DISPLAYDRV
Indicates the driver is the display driver.
DDRAWI_EMULATIONINITIALIZED
This flag is used by DirectDraw and should not be
set by the driver.
DDRAWI_EXTENDEDALIGNMENT
This flag is 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 for future use.
DDRAWI_HASCKEYDESTOVERLAY
This flag is used by DirectDraw and should not be
set by the driver.
DDRAWI_HASCKEYSRCOVERLAY
This flag is used by DirectDraw and should not be
set by the driver.
DDRAWI_HASGDIPALETTE
This flag is used by DirectDraw and should not be
set by the driver.
DDRAWI_HASGDIPALETTE_EXCLUSIVE
Reserved for future use.
DDRAWI_MODECHANGED
This flag is used by DirectDraw and should not be
set by the driver.
DDRAWI_MODEX
This flag is used by DirectDraw and should not be
set by the driver.
DDRAWI_MODEXILLEGAL
Indicates that ModeX is not supported by this
hardware.
DDRAWI_NEEDSWIN16FORVRAMLOCK
This flag is used by DirectDraw and should not be
set by the driver.
DDRAWI_NOEMULATION
This flag is used by DirectDraw and should not be
set by the driver.
DDRAWI_NOHARDWARE
This flag is used by DirectDraw and should not be
set by the driver.
DDRAWI_PALETTEINIT
This flag is used by DirectDraw and should not be
set by the driver.
DDRAWI_PDEVICEVRAMBITCLEARED
This flag is used by DirectDraw and should not be
set by the driver.
DDRAWI_SECONDARYDRIVERLOADED
This flag is used by DirectDraw and should not be
set by the driver.
DDRAWI_STANDARDVGA
This flag is used by DirectDraw and should not be
set by the driver.
DDRAWI_UMODELOADED
Reserved for future use.
DDRAWI_VIRTUALDESKTOP
This flag is used by DirectDraw and should not be
set by the driver.
fpPrimaryOrig
Pointer to the primary surface display memory.
ddCaps
Pointer to a
DDCORECAPS structure that
contains the driver capabilities.
dwInternal1
This member is used by DirectDraw and should not be filled in
by the driver.
dwUnused1[9]
Not currently used.
lpDDCBtmp
This member is used by DirectDraw and should not be filled in
by the driver.
dsList
This member is used by DirectDraw and should not be filled in
by the driver.
palList
This member is used by DirectDraw and should not be filled in
by the driver.
clipperList
This member is used by DirectDraw and should not be filled in
by the driver.
lp16DD
This member is used by DirectDraw and should not be filled in
by the driver.
dwMaxOverlays
Maximum number of overlays.
dwCurrOverlays
Current number of visible overlays.
dwMonitorFrequency
Monitor frequency in the current mode.
ddHELCaps
Pointer to a
DDCORECAPS structure that contains the HEL capabilities.
dwUnused2[50]
Not currently used.
ddckCKDestOverlay
This member is used by DirectDraw and should not be filled in
by the driver.
ddckCKSrcOverlay
This member is used by DirectDraw and should not be filled in
by the driver.
vmiData
Pointer to a
VIDMEMINFO structure that
contains information about display memory.
lpDriverHandle
Handle used by the display driver to call functions in
Ddraw16.dll.
lpExclusiveOwner
This member is used by DirectDraw and should not be filled in
by the driver.
dwModeIndex
Contains the current mode index.
dwModeIndexOrig
Contains the original mode index.
dwNumFourCC
Number of FourCC codes supported.
lpdwFourCC
This member is used by DirectDraw and should not be filled in
by the driver.
dwNumModes
Number of modes supported.
lpModeInfo
This member is used by DirectDraw and should not be filled in
by the driver.
plProcessList
This member is used by DirectDraw and should not be filled in
by the driver.
dwSurfaceLockCount
Total number of outstanding locks.
dwAliasedLockCnt
This member is used by DirectDraw and should not be filled in
by the driver.
dwReserved3
Reserved for use by the display driver.
hDD
This member is used by DirectDraw and should not be filled in
by the driver.
cObsolete[12]
This member is used by DirectDraw and should not be filled in
by the driver.
dwReserved1
Reserved for use by the display driver.
dwReserved2
Reserved for use by the display driver.
dbnOverlayRoot
The root node of the doubly linked list of overlay z orders.
lpwPDeviceFlags
This member is used by DirectDraw and should not be filled in
by the driver.
dwPDevice
This member is used by DirectDraw and should not be filled in
by the driver.
dwWin16LockCnt
This member is used by DirectDraw and should not be filled in
by the driver.
dwUnused3
This member is used by DirectDraw and should not be filled in
by the driver.
hInstance
Instance handle to the driver.
dwEvent16
An event used by the 16-bit side of the driver to tell the
32-bit side that a mode change has occurred.
dwSaveNumModes
This member is used by DirectDraw and should not be filled in
by the driver.
lpD3DGlobalDriverData
This member is used by DirectDraw and should not be filled in
by the driver.
lpD3DHALCallbacks
This member is used by DirectDraw and should not be filled in
by the driver.
ddBothCaps
Pointer to a
DDCORECAPS structure containing the logical AND of the driver
and the HEL capabilities.
lpDDVideoPortCaps
Pointer to a
DDVIDEOPORTCAPS structure containing the information returned by
the HAL (an array if more than one video port).
dvpList
lpD3DHALCallbacks2
This member is used by DirectDraw and should not be filled in
by the driver.
rectDevice
This member is used by DirectDraw and should not be filled in
by the driver.
cMonitors
This member is used by DirectDraw and should not be filled in
by the driver.
gpbmiSrc
This member is used by DirectDraw and should not be filled in
by the driver.
gpbmiDest
This member is used by DirectDraw and should not be filled in
by the driver.
phaiHeapAliases
This member is used by DirectDraw and should not be filled in
by the driver.
hKernelHandle
This member is used by DirectDraw and should not be filled in
by the driver.
pfnNotifyProc
This member is used by DirectDraw and should not be filled in
by the driver.
lpDDKernelCaps
Pointer to a
DDKERNELCAPS structure that contains the capabilities of the
kernel mode interface. Not used on Windows CE.
lpddNLVCaps
Pointer to a
DDNONLOCALVIDMEMCAPS structure that contains the hardware
non-local to local display memory capabilities.
lpddNLVHELCaps
Pointer to a
DDNONLOCALVIDMEMCAPS structure that contains the emulation
layer non-local to local display memory capabilities.
lpddNLVBothCaps
Pointer to a
DDNONLOCALVIDMEMCAPS structure that contains the logical AND
of hardware and emulation non-local to local display memory
capabilities.
lpD3DExtendedCaps
Extended capabilities for Direct3D. Not used on Windows CE.
dwDOSBoxEvent
This member is used by DirectDraw and should not be filled in
by the driver.
rectDesktop
This member is used by DirectDraw and should not be filled in
by the driver.
cDriverName[MAX_DRIVER_NAME]
This member is used by DirectDraw and should not be filled in
by the driver.
lpD3DHALCallbacks3
This member is used by DirectDraw and should not be filled in
by the driver.
dwNumZPixelFormats
This member is used by DirectDraw and should not be filled in
by the driver.
lpZPixelFormats
This member is used by DirectDraw and should not be filled in
by the driver.
mcList
This member is used by DirectDraw and should not be filled in
by the driver.
hDSVxd
This member is used by DirectDraw and should not be filled in
by the driver.
ddsCapsMore
This member is used by DirectDraw and should not be filled in
by the driver.
Last updated on Tuesday, July 13, 2004
© 2004 Microsoft Corporation. All rights reserved.