DDHAL_CANCREATESURFACEDATA (Windows Embedded CE 6.0)
1/6/2010
This structure indicates whether a surface can be created and passes that information to the DirectDraw hardware abstraction layer (DDHAL) LPDDHAL_CANCREATESURFACE callback function.
Syntax
typedef struct _DDHAL_CANCREATESURFACEDATA {
LPDDRAWI_DIRECTDRAW_GBL lpDD;
LPDDSURFACEDESC lpDDSurfaceDesc;
DWORD bIsDifferentPixelFormat;
HRESULT ddRVal;
} DDHAL_CANCREATESURFACEDATA;
Members
- lpDD
Pointer to the DDRAWI_DIRECTDRAW_GBL structure that represents the DirectDraw object.
- lpDDSurfaceDesc
Pointer to a DDSURFACEDESC structure that contains a description of the surface being created.
- bIsDifferentPixelFormat
Indicates whether the pixel format differs from the primary surface. This member is FALSE for z-buffers. However, drivers implementing the GetDriverInfo function with a GUID_ZPixelFormat instance should expect this member to be TRUE.
- ddRVal
Passes the DirectDraw return values.
Remarks
The bIsDifferentPixelFormat member is unreliable for z-buffers. Drivers should not rely on this field unless they have first checked that the surface in question is not a z-buffer Do this by checking for the presence of the DDSCAPS_ZBUFFER flag in the dwCaps member of the DDSCAPS structure pointed to by the ddsCaps member of the DDSURFACEDESC structure contained in the lpDDSurfaceDesc member of this structure.
Requirements
| Header | ddrawi.h |
| Windows Embedded CE | Windows Embedded CE 6.0 and later |
See Also
Reference
LPDDHAL_CANCREATESURFACE
DDRAWI_DIRECTDRAW_GBL
LPDDHAL_GETDRIVERINFO
Concepts
DirectDraw Display Driver Structures