NtGdiDdAttachSurface 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.]
Attaches two kernel-mode surface representations.
Syntax
BOOL APIENTRY NtGdiDdAttachSurface(
_In_ HANDLE hSurfaceFrom,
_In_ HANDLE hSurfaceTo
);
Parameters
-
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.
Return value
NtGdiDdAttachSurface returns one of the following:
| Return code | Description |
|---|---|
|
The function call succeeded. |
|
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, hSurfaceTo will not be attached to hSurfaceFrom.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 2000 Professional [desktop apps only] |
| Minimum supported server |
Windows 2000 Server [desktop apps only] |
| Header |
|
See also