DdGetDC 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 NtGdiDdGetDC function and returns a Windows Graphics Device Interface (GDI) device context (DC) that represents the Microsoft DirectDraw surface indicated.

GdiEntry7 is defined as an alias for this function.

Syntax

HDC DdGetDC(
  LPDDRAWI_DDRAWSURFACE_LCL pSurfaceLocal,
  LPPALETTEENTRY            pColorTable
);

Parameters

pSurfaceLocal

Pointer to the DirectDraw surface for which a DC is requested.

pColorTable

Optional pointer to a 256-entry array of PALETTEENTRY structures. If the color table is null, and the surface and display mode are both 8 bits per pixel, the DC shares the color table of the device.

Return value

If successful, this function returns a valid HDC; otherwise it returns NULL.

Remarks

If both the surface and the current display mode are palletized at 8 bits per pixel, the DC can be given the special property that its color table is shared by the color table of the display device. Applications are advised to call IDirectDrawSurface7::GetDC instead, which provides the same functionality in a manner independent of the operating system.

The returned DC must be freed by a call to NtGdiDdReleaseDC or GdiEntry8.

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