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.