IDirectDrawSurface
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:
| PPC | SP | ||
|---|---|---|---|
| Allocating memory | X | X | IsLost |
| X | X | Restore | |
| Attaching surfaces | X | X | EnumAttachedSurfaces |
| Blitting | X | X | AlphaBlt |
| X | X | Blt | |
| X | X | GetBltStatus | |
| Color keying | X | X | GetColorKey |
| X | X | SetColorKey | |
| Device capabilities | X | X | GetCaps |
| Device contexts | X | X | GetDC |
| X | X | ReleaseDC | |
| Flipping | X | X | Flip |
| X | X | GetFlipStatus | |
| Locking surfaces | X | X | Lock |
| X | X | Unlock | |
| Miscellaneous | X | X | GetDDInterface |
| Overlays | X | X | EnumOverlayZOrders |
| X | X | GetOverlayPosition | |
| X | X | SetOverlayPosition | |
| X | X | UpdateOverlay | |
| X | X | UpdateOverlayZOrder | |
| Surface clipper | X | X | GetClipper |
| X | X | SetClipper | |
| Surface characteristics | X | X | GetPixelFormat |
| X | X | GetSurfaceDesc | |
| Surface palettes | X | X | GetPalette |
| X | X | SetPalette |
The IDirectDrawSurface interface, like all COM interfaces, inherits the IUnknown interface methods.
The IUnknown interface supports the following three methods:
| PPC | SP | ||
|---|---|---|---|
| IUnknown | X | X | AddRef |
| X | X | QueryInterface | |
| X | X | 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
Pocket PC: Windows Mobile 5.0 and later
Smartphone: Windows Mobile 5.0 and later
OS Versions: Windows CE 5.01 and later
Header: Ddraw.h.
Library: Ddraw.lib.
Send Feedback on this topic to the authors