Share via

IVPBaseConfig::GetOverlaySurface (Windows Embedded CE 6.0)

  • Article

1/6/2010

This method determines whether the overlay mixer should use the driver's overlay surface and if so retrieves a pointer to the surface.

Syntax

HRESULT GetOverlaySurface(
  LPDIRECTDRAWSURFACE* ppddOverlaySurface
);

Parameters

  • ppddOverlaySurface
    [out] Address of a pointer to the retrieved DirectDraw overlay surface object.

Return Value

Returns NOERROR if the overlay surface object was returned. (Default implementation sets the surface to NULL and returns NOERROR.)

Remarks

The Overlay Mixer uses this function to determine if the driver requires the Overlay Mixer to use its overlay surface and if so to get a pointer to it.

If this function returns NULL, the Overlay Mixer allocates its own surface.

Requirements

Windows Embedded CE Windows CE 2.12 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later

See Also

Reference

IVPBaseConfig Interface