 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 DDHAL_CANCREATESURFACEDATAstructure contains information necessary to indicate whether a surface can be created. This structure passes the information to the DirectDraw HAL CanCreateSurfacecallback 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_GBLstructure that represents the DirectDraw object.
- lpDDSurfaceDesc
- Pointer to a DDSURFACEDESCstructure 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 GetDriverInfofunction 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 bIsDifferentPixelFormatmember 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 dwCapsmember of the DDSCAPSstructure pointed to by the ddsCapsmember of the DDSURFACEDESCstructure contained in the lpDDSurfaceDescmember of this structure).
Last updated on Tuesday, July 13, 2004