Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
1/6/2010
This method creates a GDI-compatible handle of a device context for the surface.
Syntax
HRESULT GetDC(
HDC FAR* lphDC
);
Parameters
- lphDC
Address for the returned handle to a device context.
Return Value
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_DCALREADYCREATED |
DDERR_GENERIC |
DDERR_INVALIDOBJECT |
DDERR_INVALIDPARAMS |
DDERR_SURFACELOST |
DDERR_UNSUPPORTED |
DDERR_WASSTILLDRAWING |
For more information on these error codes see DirectDraw Return Values.
Remarks
This method uses an internal version of the IDirectDrawSurface::Lock method to lock the surface. The surface remains locked until the IDirectDrawSurface::ReleaseDC method is called.
Requirements
| Header | ddraw.h |
| Library | ddraw.lib |
| Windows Embedded CE | Windows Embedded CE 6.0 and later |