DdUnattachSurface 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 DdUnattachSurface function removes an attachment, created with DdAttachSurface, between two kernel-mode surface objects.

GdiEntry12 is defined as an alias for this function.

Syntax

void DdUnattachSurface(
  [in] LPDDRAWI_DDRAWSURFACE_LCL pSurface,
  [in] LPDDRAWI_DDRAWSURFACE_LCL pSurfaceAttached
);

Parameters

[in] pSurface

Pointer to the kernel-mode surface object that was passed as the pSurfaceFrom parameter to DdAttachSurface.

[in] pSurfaceAttached

Pointer to the kernel-mode surface object that was passed as the pSurfaceTo parameter to DdAttachSurface

Return value

None

Remarks

It is recommended that applications use the DirectDraw API which handles surface attachments in a higher-level manner.

It is not necessary to call this function since the kernel will automatically destroy all attachments when DdDestroySurface is called.

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