DD_CREATESURFACEDATA structure (ddrawint.h)
The DD_CREATESURFACEDATA structure contains information necessary to create a surface--in the case of CreateD3DBuffer, a command or vertex buffer.
Syntax
typedef struct _DD_CREATESURFACEDATA {
PDD_DIRECTDRAW_GLOBAL lpDD;
PDD_SURFACEDESC lpDDSurfaceDesc;
PDD_SURFACE_LOCAL *lplpSList;
DWORD dwSCnt;
HRESULT ddRVal;
VOID *CreateSurface;
} *PDD_CREATESURFACEDATA, DD_CREATESURFACEDATA;
Members
lpDD
Points to the DD_DIRECTDRAW_GLOBAL structure that describes the driver's device.
lpDDSurfaceDesc
Points to the DDSURFACEDESC structure describing the surface or buffer that the driver should create.
lplpSList
Points to a list of DD_SURFACE_LOCAL structures describing the surface objects created by the driver. On Microsoft Windows 2000 and later, there is usually only one entry in this array. However, if the driver supports the Windows 98/Me-style surface creation techniques using DdGetDriverInfo with GUID_NTPrivateDriverCaps, and the driver sets the DDHAL_PRIVATECAP_ATOMICSURFACECREATION flag, the member contains a list of surfaces (usually more than one).
dwSCnt
Specifies the number of surfaces in the list to which lplpSList points. This value is usually 1 on Windows 2000 and later. However, if the driver support the Windows 98/Me-style surface creation techniques using DdGetDriverInfo with GUID_NTPrivateDriverCaps, the member contains the actual number of surfaces in the list (usually more than one).
ddRVal
Specifies the location in which the driver writes the return value of either the DdCreateSurface or CreateD3DBuffer callback. A return code of DD_OK indicates success. For more information, see Return Values for DirectDraw.
CreateSurface
Used by the Microsoft DirectDraw API and should not be filled in by the driver.
Requirements
| Requirement | Value |
|---|---|
| Header | ddrawint.h (include Winddi.h) |