DdDeleteDirectDrawObject function (ddrawgdi.h)

Article
02/22/2024

[This function is subject to change with each operating system revision. Instead, use the 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 NtGdiDdDeleteDirectDrawObject function and deletes a kernel-mode Microsoft DirectDraw object that was previously created using DdCreateDirectDrawObject.

GdiEntry3 is defined as an alias for this function.

Syntax

BOOL DdDeleteDirectDrawObject(
  LPDDRAWI_DIRECTDRAW_GBL pDirectDrawGlobal
);

Parameters

pDirectDrawGlobal

Pointer to the user-mode DirectDraw object. See the DDK documentation for details.

Return value

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

Remarks

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