DdCreateSurfaceObject
TOC
Collapse the table of content
Expand the table of content

DdCreateSurfaceObject function

[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 APIENTRY 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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Ddrawgdi.h

See also

Graphics Low Level Client Support

 

 

Community Additions

ADD
Show:
© 2016 Microsoft