-dxgkernel-ntgdiddcreatedirectdrawobject.md

description	ms.assetid	title	ms.topic	ms.date	topic_type	api_name	api_type	api_location
Creates a kernel-side representation of the Microsoft DirectDraw object.	e380f948-35a0-4cf0-9b69-ab2bd4f9a161	NtGdiDdCreateDirectDrawObject function (Ntgdi.h)	reference	05/31/2018	APIRef kbSyntax	NtGdiDdCreateDirectDrawObject	DllExport	Ntgdi.h Ext-MS-Win-GDI-Internal-Desktop-L1-1-0.dll GDI32.dll GDI32Full.dll

NtGdiDdCreateDirectDrawObject function

[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.]

Creates a kernel-side representation of the Microsoft DirectDraw object.

Syntax

HANDLE APIENTRY NtGdiDdCreateDirectDrawObject(
  _In_ HDC hdc
);

Parameters

hdc [in]

Any DC display device for which the DirectDraw object should be created.

Return value

If successful, this function returns a handle to the kernel-mode object representation; otherwise it returns NULL.

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]
Header	Ntgdi.h

See also

Graphics Low Level Client Support

DdCreateDirectDrawObject