IDirectDrawSurface

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Applications use the methods of the IDirectDrawSurface interface to create DirectDrawSurface objects and work with system-level variables.

IDirectDraw::CreateSurface will return a fully supported IDirectDrawSurface interface pointer.

You cannot obtain the IDirectDrawSurface interface directly from CreateSurface; use the QueryInterface method to retrieve it.

The methods of the IDirectDrawSurface interface can be organized into the following groups:

Allocating memory

IDirectDrawSurface::IsLost

 

IDirectDrawSurface::Restore

Attaching surfaces

IDirectDrawSurface::EnumAttachedSurfaces

Blitting

IDirectDrawSurface::AlphaBlt

 

IDirectDrawSurface::Blt

 

IDirectDrawSurface::GetBltStatus

Color keying

IDirectDrawSurface::GetColorKey

 

IDirectDrawSurface::SetColorKey

Device capabilities

IDirectDrawSurface::GetCaps

Device contexts

IDirectDrawSurface::GetDC

 

IDirectDrawSurface::ReleaseDC

Flipping

IDirectDrawSurface::Flip

 

IDirectDrawSurface::GetFlipStatus

Locking surfaces

IDirectDrawSurface::Lock

 

IDirectDrawSurface::Unlock

Miscellaneous

IDirectDrawSurface::GetDDInterface

Overlays

IDirectDrawSurface::EnumOverlayZOrders

 

IDirectDrawSurface::GetOverlayPosition

 

IDirectDrawSurface::SetOverlayPosition

 

IDirectDrawSurface::UpdateOverlay

 

IDirectDrawSurface::UpdateOverlayZOrder

Surface clipper

IDirectDrawSurface::GetClipper

 

IDirectDrawSurface::SetClipper

Surface characteristics

IDirectDrawSurface::GetPixelFormat

 

IDirectDrawSurface::GetSurfaceDesc

Surface palettes

IDirectDrawSurface::GetPalette

 

IDirectDrawSurface::SetPalette

The IDirectDrawSurface interface, like all COM interfaces, inherits the IUnknown interface methods.

The IUnknown interface supports the following three methods:

IUnknown

IUnknown::AddRef

 

IUnknown::QueryInterface

 

IUnknown::Release

You can use the LPDIRECTDRAWSURFACE data type to declare variables that point to various DirectDrawSurface object interfaces.

The Ddraw.h header file declares this data type with the following code.

typedef struct IDirectDrawSurface     FAR *LPDIRECTDRAWSURFACE;

Requirements

Header ddraw.h
Library ddraw.lib
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later