DDHAL_CANCREATESURFACEDATA

  • Article

The DDHAL_CANCREATESURFACEDATA structure contains information necessary to indicate whether a surface can be created. This structure passes the information to the DirectDraw HAL CanCreateSurface callback function.

typedef struct _DDHAL_CANCREATESURFACEDATA
{
LPDDRAWI_DIRECTDRAW_GBL    lpDD;
LPDDSURFACEDESC            lpDDSurfaceDesc;
DWORD                      bIsDifferentPixelFormat;
HRESULT                    ddRVal;
LPDDAHL_CANCREATESURFACE   CanCreateSurface;
} 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 has always been 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.
  • CanCreateSurface
    This member is used by DirectDraw and should not be filled in by the driver.

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 (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).

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.