IDirectDraw4::GetSurfaceFromDC
The IDirectDraw4::GetSurfaceFromDC method retrieves the IDirectDrawSurface4 interface for a surface based on its GDI device context handle.
HRESULT GetSurfaceFromDC(
HDC hdc,
LPDIRECTDRAWSURFACE4 *lpDDS4);
Parameters
- hdc
Handle to a display device context. - lpDDS4
Address of a variable that will be filled with a valid IDirectDrawSurface4 interface pointer if the call succeeds.
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:
| DDERR_GENERIC |
| DDERR_INVALIDPARAMS |
| DDERR_OUTOFMEMORY |
| DDERR_NOTFOUND |
Remarks
This method will succeed only for device context handles that identify surfaces already associated with the DirectDraw object.
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 |
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.