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

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.

Syntax

DWORD APIENTRY NtGdiDdGetDxHandle(
  _In_ HANDLE hDirectDraw,
  _In_ HANDLE hSurface,
  _In_ BOOL   bRelease
);

Parameters

hDirectDraw [in]

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

hSurface [in]

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

bRelease [in]

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 hDirectDraw and hSurface are specified, hSurface is ignored.

Requirements

See also

Graphics Low Level Client Support