 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
The IDirectDraw4::DuplicateSurfacemethod duplicates a DirectDrawSurface object.
HRESULT DuplicateSurface( LPDIRECTDRAWSURFACE4 lpDDSurface , LPLPDIRECTDRAWSURFACE4 FAR * lplpDupDDSurface );
Parameters
- lpDDSurface
- Address of the IDirectDrawSurface4interface for the surface to be duplicated.
- lplpDupDDSurface
- Address of a variable that will be filled with an
IDirectDrawSurface5interface pointer for the newly
duplicated DirectDrawSurface object.
Return Values
If the method succeeds, the return value is DD_OK.
If the method fails, the return value may be one of the following error values:
Remarks
This method creates a new DirectDrawSurface object that points to the same surface memory as an existing DirectDrawSurface object. This duplicate can be used just like the original object. The surface memory is released after the last object referencing it is released. A primary surface, 3-D surface, or implicitly created surface cannot be duplicated.
Requirements
Runs on Versions Declared in Link to Windows CE OS 2.12 or later. Version 2.12 requires DXPAK 1.0 or later. ddraw.h ddraw.lib