DdCreateSurfaceObject function (ddrawgdi.h)

Article
02/22/2024

[This function is subject to change with each operating system revision. Instead, use the Microsoft DirectDraw and Microsoft Direct3DAPIs; these APIs insulate applications from such operating system changes, and hide many other difficulties involved in interacting directly with display drivers.]

Wrapper for the NtGdiDdCreateSurfaceObject function and creates a kernel-mode surface object.

GdiEntry4 is defined as an alias for this function.

Syntax

BOOL DdCreateSurfaceObject(
  LPDDRAWI_DDRAWSURFACE_LCL pSurfaceLocal,
  BOOL                      bPrimarySurface
);

Parameters

pSurfaceLocal

Pointer to the user-mode surface object. See the DDK documentation for details. A handle to the kernel-mode object is placed in pSurfaceLocal->hDDSurface.

bPrimarySurface

Reserved.

Return value

If successful, this function returns TRUE; otherwise it returns FALSE.

Remarks

This function is used to create objects that represent system memory surfaces. Video memory surfaces are given a kernel-mode representation as an implicit part of the NtGdiDdCreateSurfaceObject call.

Applications are advised to use the DirectDraw and Direct3D APIs to create and manage graphics device objects. These constructs abstract the device creation process in a simplified and operating-system-independent way.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	ddrawgdi.h