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

The DdAttachSurface function attaches two kernel-mode surface representations.

GdiEntry11 is defined as an alias for this function.

Syntax

BOOL DdAttachSurface(
  [in] LPDDRAWI_DDRAWSURFACE_LCL pSurfaceFrom,
  [in] LPDDRAWI_DDRAWSURFACE_LCL pSurfaceTo
);

Parameters

[in] pSurfaceFrom

Pointer to a kernel-mode surface object that will be the start point of the new attachment.

[in] pSurfaceTo

Pointer to a kernel-mode surface object that will be the end point of the new attachment.

Return value

DdAttachSurface returns one of the following:

Return code	Description
TRUE	The function call succeeded.
FALSE	The function call failed.

Remarks

See the DirectDraw software development kit (SDK) and Driver Development Kit (DDK) for a full description of surface attachments.

Note As with other surface attachments, the resulting attachment is one-way. After this function is called, pSurfaceTo will not be attached to pSurfaceFrom.

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