IDirectDrawSurface7::GetDC

The IDirectDrawSurface7::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 of a device context.

Return Values

If the method succeeds, the return value is DD_OK.

If it fails, the method can return one of the following error values:

Remarks

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.

ReleaseDC must be called from the same thread that called GetDC.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 98.
  Header: Declared in ddraw.h.

See Also

IDirectDrawSurface7::Lock