IDirectDrawSurface4::GetDC

The IDirectDrawSurface4::GetDC method creates a GDI-compatible handle of a device context for the surface.

HRESULT GetDC(
  HDC FAR *lphDC  
);
 

Parameters

lphDC

Address for the returned handle to a device context.

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 uses an internal version of the IDirectDrawSurface4::Lock method to lock the surface. The surface remains locked until the IDirectDrawSurface4::ReleaseDC method is called.

QuickInfo

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in ddraw.h.
  Import Library: Use ddraw.lib.

See Also

IDirectDrawSurface4::Lock