 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_DDRAWSURFACE_GBL_MOREstructure contains additional global DirectDrawSurfacedata that can be shared between object instances.
typedef struct _DDRAWI_DDRAWSURFACE_GBL_MORE { DWORD
dwSize
;
union
{
DWORD
dwPhysicalPageTable
;
FLATPTR
fpPhysicalVidMem
;
};
LPDWORD
pPageTable
;
DWORD
cPages
;
DWORD
dwSavedDCContext
;
FLATPTR
fpAliasedVidMem
;
ULONG_PTR
dwDriverReserved
;
ULONG_PTR
dwHELReserved
;
DWORD
cPageUnlocks
;
DWORD
hKernelSurface
;
DWORD
dwKernelRefCnt
;
LPDDCOLORCONTROL
lpColorInfo
;
FLATPTR
fpNTAlias
;
DWORD
dwContentsStamp
;
LPVOID
lpDDRAWReserved1
;
LPVOID
lpDDRAWReserved2
;
DWORD
dwDDRAWReserved1
;
DWORD
dwDDRAWReserved2
;
} DDRAWI_DDRAWSURFACE_GBL_MORE;
Members
- dwSize
- Size of the structure. This member must be initialized before the structure is used.
- dwPhysicalPageTable
- Physical address of the page table (an array of physical addresses at one per 4K page). This is the physical address of the table of physical addresses of the pages that hold the page locked system memory surface. This table will be valid whenever the dwPageLockCountmember of the DDRAWI_DDRAWSURFACE_MOREstructure is non-zero.
- fpPhysicalVidMem
- Physical address ofthe surface (non-local display memory only).
- pPageTable
- Linear address of the page table whose physical address is given in dwPhysicalPageTable.
- cPages
- Indicates the count of elements in the array pointed to by dwPhysicalPageTableand pPageTable. This is equal to the number of physical pages representing the surface.
- dwSavedDCContext
- This member is used by DirectDraw and should not be filled in by the driver.
- fpAliasedVidMem
- This member is used by DirectDraw and should not be filled in by the driver.
- dwDriverReserved
- Reserved for driver use (both system and display memory surfaces).
- dwHELReserved
- This member is used by DirectDraw and should not be filled in by the driver.
- cPageUnlocks
- This value is incremented whenever the surface is page unlocked. Drivers can cache the physical page table of a surface, then check this value whenever a new DMA request is received. If the value has changed, then the driver's cache of the physical page table needs to be updated. If not, the surface has remained page locked since the last time it was passed to the driver.
- hKernelSurface
- Kernel handle for this surface.
- dwKernelRefCnt
- This member is used by DirectDraw and should not be filled in by the driver.
- lpColorInfo
- This member is used by DirectDraw and should not be filled in by the driver.
- fpNTAlias
- This member is used internally by Windows NT DirectDraw and should not be filled in by the driver.
- dwContentsStamp
- Changes when the surface data may have changed. 0 means no information.
- lpDDRAWReserved1 and lpDDRAWReserved2
- Reserved for future use.
- dwDDRAWReserved1 and dwDDRAWReserved2
- Reserved for future use.
Remarks
Driver writers should use the GET_LPDDRAWSURFACE_GBL_MOREmacro to traverse from a DDRAWI_DDRAWSURFACE_GBLaddress to the DDRAWI_DDRAWSURFACE_GBL_MOREstructure.
Last updated on Tuesday, July 13, 2004