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

Returns the kernel-mode Microsoft DirectX API handle to use in subsequent calls to the kernel-mode entry points that control the DirectX API mechanism.

GdiEntry14 is defined as an alias for this function.

Syntax

HANDLE DdGetDxHandle(
  [in] LPDDRAWI_DIRECTDRAW_LCL   pDDraw,
  [in] LPDDRAWI_DDRAWSURFACE_LCL pSurface,
  [in] BOOL                      bRelease
);

Parameters

[in] pDDraw

Pointer to the DirectDraw object owning the surface. This parameter is optional and may be set to NULL.

[in] pSurface

Pointer to the surface for which to return a kernel-mode DirectX API handle. This parameter is optional and may be set to NULL.

[in] bRelease

Set to TRUE if the DirectX API kernel mode interface should be released. Otherwise, FALSE.

Return value

A DirectX API handle used in subsequent DirectX API-oriented kernel entry points.

Remarks

If both pDDraw and pSurface are specified, pSurface is ignored.

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