次の方法で共有


CAggDrawSurface Class (Compact 2013)

3/26/2014

IDirectDrawSurface

**     CAggDrawSurface Class**

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 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, CAggDrawSurface::SetDirectDrawSurface, and CAggDrawSurface::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::CAggDrawSurface

Constructs a CAggDrawSurface object.

CAggDrawSurface::SetDirectDrawSurface

Sets the DirectDraw object to be aggregated by this class.

This must be called before IDirectDrawSurface interface methods can be called.

Overrideable Member Functions

Member function

Description

CAggDrawSurface::NonDelegatingQueryInterface

Retrieves an interface and increments the reference count.

Implemented IDirectDrawSurface Methods

Method

Description

IDirectDrawSurface::AddOverlayDirtyRect

Not implemented.

IDirectDrawSurface::Blt

Performs a bit-block transfer.

IDirectDrawSurface::EnumAttachedSurfaces

Enumerates all the surfaces attached to a given surface.

IDirectDrawSurface::EnumOverlayZOrders

Enumerates the overlays on the specified destination. The overlays can be enumerated in front-to-back or back-to-front order.

IDirectDrawSurface::Flip

Makes the surface memory associated with the DDSCAPS_BACKBUFFER surface become associated with the FRONTBUFFER surface.

IDirectDrawSurface::GetBltStatus

Retrieves the status of a bit block transfer.

IDirectDrawSurface::GetCaps

Retrieves the capabilities of the surface.

IDirectDrawSurface::GetClipper

Retrieves the DirectDrawClipper object associated with this surface.

IDirectDrawSurface::GetColorKey

Retrieves the color key value for the DirectDrawSurface object.

IDirectDrawSurface::GetDC

Creates a GDI-compatible hDC for the surface.

IDirectDrawSurface::GetFlipStatus

Returns OK if the surface that it is called on has finished its flipping process; otherwise, returns DDERR_WASSTILLDRAWING.

IDirectDrawSurface::GetOverlayPosition

Retrieves the display coordinates of the surface, given a visible, active overlay surface (DDSCAPS_OVERLAY set).

IDirectDrawSurface::GetPalette

Retrieves the DirectDrawPalette structure associated with this surface.

IDirectDrawSurface::GetPixelFormat

Retrieves the color and pixel format of the surface.

IDirectDrawSurface::GetSurfaceDesc

Retrieves a DDSURFACEDESC structure describing the surface in its current condition.

IDirectDrawSurface::IsLost

Determines if the surface memory associated with a DirectDrawSurface object has been freed.

IDirectDrawSurface::Lock

Obtains a valid pointer to the surface memory.

IDirectDrawSurface::ReleaseDC

Releases a GDI-compatible hDC previously obtained through CAggDrawSurface::GetDC.

IDirectDrawSurface::Restore

Restores a surface that has been "lost." The surface memory associated with the DirectDrawSurface object has been freed.

IDirectDrawSurface::SetClipper

Attaches a DirectDrawClipper object to a DirectDrawSurface object.

IDirectDrawSurface::SetColorKey

Sets the color key value for the DirectDrawSurface object if the hardware supports color keys on a per-surface basis.

IDirectDrawSurface::SetOverlayPosition

Changes the display coordinates of an overlay surface.

IDirectDrawSurface::SetPalette

Not supported.

IDirectDrawSurface::Unlock

Notifies DirectDraw that the direct surface manipulations are complete.

IDirectDrawSurface::UpdateOverlay

Repositions and/or modifies the visual attributes of an overlay surface. These surfaces must have the DDSCAPS_OVERLAY bit set.

IDirectDrawSurface::UpdateOverlayZOrder

Sets an overlay's z-order.

The z-order determines which overlay should be occluded when multiple overlays are displayed simultaneously.

Requirements

Header

ddraw.h,
dshow.h,
Streams.h

Library

ole32.lib,
Ole32auth.lib,
Strmbase.lib,
Strmiids.lib,
uuid.lib

See Also

Reference

DirectShow Classes