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

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 APIENTRY DdUnattachSurface(
  _In_ LPDDRAWI_DDRAWSURFACE_LCL pSurface,
  _In_ LPDDRAWI_DDRAWSURFACE_LCL pSurfaceAttached
);

Parameters

pSurface [in]

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

pSurfaceAttached [in]

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

Return value

This function does not return a value.

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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Ddrawgdi.h

See also

Graphics Low Level Client Support

 

 

Show: