DDHAL_CANCREATESURFACEDATA (Compact 2013)

3/26/2014

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

  • 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 LPDDHAL_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

See Also

Reference

DirectDraw Display Driver Structures
LPDDHAL_CANCREATESURFACE
DDRAWI_DIRECTDRAW_GBL
LPDDHAL_GETDRIVERINFO

Other Resources

DDSURFACEDESC
DDSCAPS