Microsoft Windows CE 3.0  

CAggDrawSurface Class

This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

The CAggDrawSurfaceclass aggregates an IDirectDrawSurfaceinterface. Although Microsoft DirectDraw interfaces ( IDirectDrawand IDirectDrawSurface) potentially can be aggregated, this feature is not yet implemented. Various parts of Microsoft DirectShow require aggregation of the DirectDraw interfaces. In particular, the video renderer passes out media samples that expose IDirectDrawand IDirectDrawSurface. This class and the CAggDirectDrawclass republish the methods of the DirectDraw class so that they can be aggregated.

Each member function in this class, with the exception of the constructor, SetDirectDrawSurface, and NonDelegatingQueryInterface, simply calls the corresponding method on the IDirectDrawSurfaceinterface with the parameters passed to it.

Protected Data Members

m_pDirectDrawSurface DirectDraw surface.

Member Functions

CAggDrawSurface Constructs a CAggDrawSurfaceobject.
SetDirectDrawSurface Sets the DirectDraw object to be aggregated by this class. This must be called before any of the IDirectDrawSurfaceinterface methods can be called.

Overridable Member Functions

NonDelegatingQueryInterface Retrieves an interface and increments the reference count.

Implemented IDirectDrawSurface Methods

AddAttachedSurface Attaches a surface to another surface. Examples of possible attachments include z-buffers, alpha channels, and back buffers.
AddOverlayDirtyRect Builds up the list of the rectangles that must be updated the next time the UpdateOverlayDisplaymember function is called.
Blt Performs a bit-block transfer.
BltFast Performs a source copy bit-block transfer or transparent bit-block transfer using a source or destination color key.
DeleteAttachedSurface Detaches two attached surfaces.
EnumAttachedSurfaces Enumerates all the surfaces attached to a given surface.
EnumOverlayZOrders Enumerates the overlays on the specified destination. The overlays can be enumerated in front-to-back or back-to-front order.
Flip Makes the surface memory associated with the DDSCAPS_BACKBUFFER surface become associated with the FRONTBUFFER surface.
GetAttachedSurface Finds the attached surface that has the specified capabilities.
GetBltStatus Retrieves the status of a bit block transfer.
GetCaps Retrieves the capabilities of the surface.
GetClipper Retrieves the DirectDrawClipper object associated with this surface.
GetColorKey Retrieves the color key value for the DirectDrawSurface object.
GetDC Creates a GDI-compatible hDC for the surface.
GetFlipStatus Returns OK if the surface that it is called on has finished its flipping process; otherwise, returns DDERR_WASSTILLDRAWING.
GetOverlayPosition Retrieves the display coordinates of the surface, given a visible, active overlay surface (DDSCAPS_OVERLAY set).
GetPalette Retrieves the DirectDrawPalette structure associated with this surface.
GetPixelFormat Retrieves the color and pixel format of the surface.
GetSurfaceDesc Retrieves a DDSURFACEDESCstructure describing the surface in its current condition.
Initialize Initializes a DirectDrawSurface object.
IsLost Determines if the surface memory associated with a DirectDrawSurface object has been freed.
Lock Obtains a valid pointer to the surface memory.
ReleaseDC Releases a GDI-compatible hDC previously obtained through CAggDrawSurface::GetDC.
Restore Restores a surface that has been "lost." The surface memory associated with the DirectDrawSurface object has been freed.
SetClipper Attaches a DirectDrawClipper object to a DirectDrawSurface object.
SetColorKey Sets the color key value for the DirectDrawSurface object if the hardware supports color keys on a per-surface basis.
SetOverlayPosition Changes the display coordinates of an overlay surface.
SetPalette Attaches the DirectDrawPalette object specified to a DirectDrawSurface.
Unlock Notifies DirectDraw that the direct surface manipulations are complete.
UpdateOverlay Repositions and/or modifies the visual attributes of an overlay surface. These surfaces must have the DDSCAPS_OVERLAY bit set.
UpdateOverlayDisplay Repaints the rectangles in the dirty rectangle lists of all active overlays.
UpdateOverlayZOrder Sets an overlay's z-order. The z-order determines which overlay should be occluded when multiple overlays are displayed simultaneously.