CAggDrawSurface Class
.gif)
This class aggregates an IDirectDrawSurface interface. Although DirectDraw interfaces (IDirectDraw and IDirectDrawSurface) potentially can be aggregated, this feature is not yet implemented. Various parts of DirectShow require aggregation of the DirectDraw interfaces. In particular, the video renderer passes out media samples that expose IDirectDraw and IDirectDrawSurface. This class and the CAggDirectDraw class 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 IDirectDrawSurface interface with the parameters passed to it.
Protected Data Members
| Member | Description |
|---|---|
| m_pDirectDrawSurface | DirectDraw surface. |
Member Functions
| Member function | Description |
|---|---|
| CAggDrawSurface | Constructs a CAggDrawSurface object. |
| SetDirectDrawSurface | Sets the DirectDraw object to be aggregated by this class. This must be called before any of the IDirectDrawSurface interface methods can be called. |
Overrideable Member Functions
| Member function | Description |
|---|---|
| NonDelegatingQueryInterface | Retrieves an interface and increments the reference count. |
Implemented IDirectDrawSurface Methods
| Method | Description |
|---|---|
| IDirectDrawSurface5::AddAttachedSurface | Attaches a surface to another surface. Examples of possible attachments include z-buffers, alpha channels, and back buffers. |
| IDirectDrawSurface5::AddOverlayDirtyRect | Builds up the list of the rectangles that must be updated the next time the UpdateOverlayDisplay member function is called. |
| IDirectDrawSurface5::Blt | Performs a bit-block transfer. |
| IDirectDrawSurface5::BltFast | Performs a source copy bit-block transfer or transparent bit-block transfer using a source or destination color key. |
| IDirectDrawSurface5::DeleteAttachedSurface | Detaches two attached surfaces. |
| IDirectDrawSurface5::EnumAttachedSurfaces | Enumerates all the surfaces attached to a given surface. |
| IDirectDrawSurface5::EnumOverlayZOrders | Enumerates the overlays on the specified destination. The overlays can be enumerated in front-to-back or back-to-front order. |
| IDirectDrawSurface5::Flip | Makes the surface memory associated with the DDSCAPS_BACKBUFFER surface become associated with the FRONTBUFFER surface. |
| IDirectDrawSurface5::GetAttachedSurface | Finds the attached surface that has the specified capabilities. |
| IDirectDrawSurface5::GetBltStatus | Retrieves the status of a bit block transfer. |
| IDirectDrawSurface5::GetCaps | Retrieves the capabilities of the surface. |
| IDirectDrawSurface5::GetClipper | Retrieves the DirectDrawClipper object associated with this surface. |
| IDirectDrawSurface5::GetColorKey | Retrieves the color key value for the DirectDrawSurface object. |
| IDirectDrawSurface5::GetDC | Creates a GDI-compatible hDC for the surface. |
| IDirectDrawSurface5::GetFlipStatus | Returns OK if the surface that it is called on has finished its flipping process; otherwise, returns DDERR_WASSTILLDRAWING. |
| IDirectDrawSurface5::GetOverlayPosition | Retrieves the display coordinates of the surface, given a visible, active overlay surface (DDSCAPS_OVERLAY set). |
| IDirectDrawSurface5::GetPalette | Retrieves the DirectDrawPalette structure associated with this surface. |
| IDirectDrawSurface5::GetPixelFormat | Retrieves the color and pixel format of the surface. |
| IDirectDrawSurface5::GetSurfaceDesc | Retrieves a DDSURFACEDESC structure describing the surface in its current condition. |
| IDirectDrawSurface5::Initialize | Initializes a DirectDrawSurface object. |
| IDirectDrawSurface5::IsLost | Determines if the surface memory associated with a DirectDrawSurface object has been freed. |
| IDirectDrawSurface5::Lock | Obtains a valid pointer to the surface memory. |
| IDirectDrawSurface5::ReleaseDC | Releases a GDI-compatible hDC previously obtained through CAggDrawSurface::GetDC. |
| IDirectDrawSurface5::Restore | Restores a surface that has been "lost." The surface memory associated with the DirectDrawSurface object has been freed. |
| IDirectDrawSurface5::SetClipper | Attaches a DirectDrawClipper object to a DirectDrawSurface object. |
| IDirectDrawSurface5::SetColorKey | Sets the color key value for the DirectDrawSurface object if the hardware supports color keys on a per-surface basis. |
| IDirectDrawSurface5::SetOverlayPosition | Changes the display coordinates of an overlay surface. |
| IDirectDrawSurface5::SetPalette | Attaches the DirectDrawPalette object specified to a DirectDrawSurface. |
| IDirectDrawSurface5::Unlock | Notifies DirectDraw that the direct surface manipulations are complete. |
| IDirectDrawSurface5::UpdateOverlay | Repositions and/or modifies the visual attributes of an overlay surface. These surfaces must have the DDSCAPS_OVERLAY bit set. |
| IDirectDrawSurface5::UpdateOverlayDisplay | Repaints the rectangles in the dirty rectangle lists of all active overlays. |
| IDirectDrawSurface5::UpdateOverlayZOrder | Sets an overlay's z-order. The z-order determines which overlay should be occluded when multiple overlays are displayed simultaneously. |
Requirements
DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.
OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header:
Last updated on Wednesday, April 13, 2005
© 2005 Microsoft Corporation. All rights reserved.