| DirectX SDK |
The IDirectDrawSurface7::GetDC method creates a GDI-compatible handle of a device context for the surface.
HRESULT GetDC( HDC FAR *lphDC );
If the method succeeds, the return value is DD_OK.
If it fails, the method can return one of the following error values:
| DDERR_DCALREADYCREATED |
| DDERR_GENERIC |
| DDERR_INVALIDOBJECT |
| DDERR_INVALIDPARAMS |
| DDERR_INVALIDSURFACETYPE |
| DDERR_SURFACELOST |
| DDERR_UNSUPPORTED |
| DDERR_WASSTILLDRAWING |
This method uses an internal version of the IDirectDrawSurface7::Lock method to lock the surface. The surface remains locked until the IDirectDrawSurface7::ReleaseDC method is called.
Windows NT/2000: Requires Windows 2000.
Windows 95/98: Requires Windows 98.
Header: Declared in ddraw.h.