IDirectDraw (Compact 2013)

3/26/2014

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

Methods

In addition to the methods inherited from IUnknown this interface exposes the following methods.

Method

Description

IDirectDraw::CreateClipper

Creates a DirectDrawClipper object.

IDirectDraw::CreateSurface

Creates a DirectDrawSurface object for this DirectDraw object.

IDirectDraw::EnumDisplayModes

Enumerates all of the display modes the hardware exposes through the DirectDraw object that are compatible with a provided surface description.

IDirectDraw::EnumSurfaces

Enumerates all of the existing or possible surfaces that meet the specified surface description.

IDirectDraw::FlipToGDISurface

Makes the surface that the Graphics Device Interface (GDI) writes to the primary surface.

IDirectDraw::GetAvailableVidMem

Retrieves the total amount of display memory available and the amount of display memory currently free for a given type of surface.

IDirectDraw::GetCaps

Fills in the capabilities of the device driver for the hardware and the software emulation.

IDirectDraw::GetDeviceIdentifier

Retrieves the current display device's identifying information.

IDirectDraw::GetDisplayMode

Retrieves the current display mode.

IDirectDraw::GetFourCCCodes

Retrieves the FOURCC codes supported by the DirectDraw object. This method can also retrieve the number of codes supported.

IDirectDraw::GetGDISurface

Retrieves the DirectDrawSurface object that currently represents the surface memory that GDI is treating as the primary surface.

IDirectDraw::GetMonitorFrequency

Retrieves the frequency of the monitor being driven by the DirectDraw object.

IDirectDraw::GetScanLine

Retrieves the scan line that is currently being drawn on the monitor.

IDirectDraw::GetSurfaceFromDC

Retrieves the IDirectDrawSurface interface for a surface based on its GDI device context handle.

IDirectDraw::GetVerticalBlankStatus

Retrieves the status of the vertical blank.

IDirectDraw::RestoreAllSurfaces

Restores all the surfaces created for the DirectDraw object, in the order they were created.

IDirectDraw::RestoreDisplayMode

Resets the mode of the display device hardware for the primary surface to what it was before the IDirectDraw::SetDisplayMode method was called. Exclusive-level access is required to use this method.

IDirectDraw::SetCooperativeLevel

Determines the top-level behavior of the application.

IDirectDraw::SetDisplayMode

Sets the mode of the display-device hardware.

IDirectDraw::TestCooperativeLevel

Reports the current cooperative-level status of the DirectDraw device for a windowed or full-screen application.

IDirectDraw::WaitForVerticalBlank

Helps the application synchronize itself with the vertical-blank interval.

Remarks

The IDirectDraw::Initialize method is not supported in Windows Embedded Compact.

You can use the LPDIRECTDRAW to declare a variable that contains a pointer to an IDirectDraw interface. The Ddraw.h header file declares this data type with the following code.

typedef struct IDirectDraw*LPDIRECTDRAW;

Requirements

Header

ddraw.h

Library

ddraw.lib

See Also

Reference

DirectDraw Interfaces
DirectDraw Reference

Other Resources

DirectDraw