DdUnattachSurface function (ddrawgdi.h)
[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 |