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

Wrapper for the NtGdiDdReleaseDC function and releases a device context (DC) previously obtained through DdGetDC or GdiEntry7.

GdiEntry8 is defined as an alias for this function.

Syntax

BOOL DdReleaseDC(
  LPDDRAWI_DDRAWSURFACE_LCL pSurfaceLocal
);

Parameters

pSurfaceLocal

Pointer to the DirectDraw surface for which a DC was obtained.

Return value

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

Remarks

Applications that need to obtain a DC for a DirectDraw surface can use IDirectDrawSurface7::GetDC, which exposes this functionality in a manner independent of the operating system.

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