DirectDraw Object Types

You can think of DirectDraw as being composed of several objects that work together. This topic describes the objects you use when working with the DirectDraw component, organized by object type. For detailed information, see Working with DirectDraw Objects.

The following table shows the objects used by the DirectDraw component.

Object Description
DirectDraw The DirectDraw object is the heart of all DirectDraw applications. It is the first object you create, and you use it to make all other related objects. You create a DirectDraw object by calling the DirectDrawCreate function. DirectDraw objects expose their functionality through the IDirectDraw, IDirectDraw2, and IDirectDraw4 interfaces. For more information, see Working with DirectDraw Objects.
DirectDrawClipper The DirectDrawClipper object (casually referred to as a clipper) helps you prevent blitting to certain portions of a surface or beyond the bounds of a surface. You can create a clipper by calling the IDirectDraw4::CreateClipper method. DirectDrawClipper objects expose their functionality through the IDirectDrawClipper interface. For more information, see Working with DirectDraw Clippers.
DirectDrawColorControl The DirectDrawColorControl object allows you to get and set color controls. This object is accessed through the IDirectDrawColorControl interface.
DirectDrawPalette The DirectDrawPalette object (casually referred to as a palette) represents a 16- or 256-color indexed palette to be used with a surface. It contains a series of indexed RGB triplets that describe colors associated with values within a surface. You do not use palettes with surfaces that use a pixel format depth greater than 8 bits. You can create a DirectDrawPalette object by calling the IDirectDraw4::CreatePalette method. DirectDrawPalette objects expose their functionality through the IDirectDrawPalette interface. For more information, see Working with DirectDraw Palettes.
DirectDrawSurface The DirectDrawSurface object (casually referred to as a surface) represents an area in memory that holds data to be displayed on the monitor as images or moved to other surfaces. You usually create a surface by calling the IDirectDraw4::CreateSurface method of the DirectDraw object with which it will be associated. DirectDrawSurface objects expose their functionality through the IDirectDrawSurface5 interface. For more information, see Working with DirectDraw Surfaces.
DirectDrawVideoPort The DirectDrawVideoPort object represents video-port hardware present in some systems. This hardware allows direct access to the frame buffer without accessing the CPU or using the PCI bus. You can create a DirectDrawVideoPort object by calling a IUnknown::QueryInterface method for the DirectDraw object, specifying the IID_IDDVideoPortContainer reference identifier. DirectDrawVideoPort objects expose their functionality through the IDDVideoPortContainer and IDirectDrawVideoPort interfaces. For more information, see Video Ports.

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.