DirectX SDK

IDirectDraw7::CreateSurface

The IDirectDraw7::CreateSurface method creates a DirectDrawSurface object for this DirectDraw object.

HRESULT CreateSurface(
  LPDDSURFACEDESC2 lpDDSurfaceDesc2,        
  LPDIRECTDRAWSURFACE7 FAR *lplpDDSurface,  
  IUnknown FAR *pUnkOuter                  
);

Parameters

lpDDSurfaceDesc2: Address of a DDSURFACEDESC2 structure that describes the requested surface. Set any unused members of the DDSURFACEDESC2 structure to 0 before calling this method. A DDSCAPS2 structure is a member of DDSURFACEDESC2.
lplpDDSurface: Address of a variable to be set to a valid IDirectDrawSurface7 interface pointer if the call succeeds.
pUnkOuter: Allows for future compatibility with COM aggregation features. Presently, however, this method returns an error if this parameter is anything but NULL.