DD_SYNCSURFACEDATA structure (ddrawint.h)
The DD_SYNCSURFACEDATA structure contains the surface information.
Syntax
typedef struct _DD_SYNCSURFACEDATA {
PDD_DIRECTDRAW_LOCAL lpDD;
PDD_SURFACE_LOCAL lpDDSurface;
DWORD dwSurfaceOffset;
ULONG_PTR fpLockPtr;
LONG lPitch;
DWORD dwOverlayOffset;
ULONG dwDriverReserved1;
ULONG dwDriverReserved2;
ULONG dwDriverReserved3;
ULONG dwDriverReserved4;
HRESULT ddRVal;
} *PDD_SYNCSURFACEDATA, DD_SYNCSURFACEDATA;
Members
lpDD
Points to a DD_DIRECTDRAW_LOCAL structure that is relevant to the current Microsoft DirectDraw process only.
lpDDSurface
Points to the DD_SURFACE_LOCAL structure that describes the surface with which to sync.
dwSurfaceOffset
Contains the byte offset from the start of the frame buffer to the start of the surface. This value is used only by the video miniport driver. This member must contain data that is filled in by the driver.
fpLockPtr
Contains the pointer value to be returned by the DdLock call for accessing the surface. This value is used by a kernel-mode client. This member can be modified by the driver, but does not need to be.
lPitch
Contains the pitch in bytes passed to the client during a DdLock call. This member can be modified by the driver, but does not need to be.
dwOverlayOffset
Contains the byte offset from the start of the frame buffer to the start of the overlay. This value is used only by the video miniport driver and may be different than the dwSurfaceOffset member if cropping is involved or if the overlay origin is not the top left of the surface. This member must contain data that is filled in by the driver.
dwDriverReserved1
Reserved for use by the display driver.
dwDriverReserved2
Reserved for use by the display driver.
dwDriverReserved3
Reserved for use by the display driver.
dwDriverReserved4
Reserved for use by the display driver. Windows 2000 and later only.
ddRVal
Specifies the location in which the driver writes the return value of the DdSyncSurfaceData callback. A return code of DD_OK indicates success. For more information, see Return Values for DirectDraw.
Requirements
| Requirement | Value |
|---|---|
| Header | ddrawint.h (include Winddi.h) |