| description | ms.assetid | title | ms.topic | ms.date | topic_type | api_name | api_type | api_location | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Attaches two kernel-mode surface representations. |
f1b1859f-8b62-4385-9e8a-296086446fe7 |
NtGdiDdAttachSurface function (Ntgdi.h) |
reference |
05/31/2018 |
|
|
|
|
[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.]
Attaches two kernel-mode surface representations.
BOOL APIENTRY NtGdiDdAttachSurface(
_In_ HANDLE hSurfaceFrom,
_In_ HANDLE hSurfaceTo
);-
hSurfaceFrom [in]
-
Handle to kernel-mode surface object that will be the start point of the new attachment.
-
hSurfaceTo [in]
-
Handle to kernel-mode surface object that will be the end point of the new attachment.
NtGdiDdAttachSurface returns one of the following:
| Return code | Description |
|---|---|
|
The function call succeeded. |
|
The function call failed. |
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, hSurfaceTo will not be attached to hSurfaceFrom.
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 2000 Professional [desktop apps only] |
| Minimum supported server |
Windows 2000 Server [desktop apps only] |
| Header |
|