IDirectDrawVideo::GetSurfaceType

 
Microsoft DirectShow 9.0

IDirectDrawVideo::GetSurfaceType

The GetSurfaceType method retrieves the actual surface type as a DirectShow DirectDraw Surface (AMDDS) definition.

Syntax

  HRESULT GetSurfaceType(
  DWORD *pSurfaceType
);

Parameters

pSurfaceType

Pointer to variable that receives a bitwise-OR of one or more of the following values.

Value Description
AMDDS_NONE No use for DCI/DirectDraw.
AMDDS_DCIPS Use DCI primary surface.
AMDDS_PS Use DirectDraw primary surface.
AMDDS_RGBOVR RGB overlay surfaces.
AMDDS_YUVOVR YUV overlay surfaces.
AMDDS_RGBOFF RGB off-screen surfaces.
AMDDS_YUVOFF YUV off-screen surfaces.
AMDDS_RGBFLP RGB flipping surfaces.
AMDDS_YUVFLP YUV flipping surfaces.
AMDDS_ALL All the previous flags.
AMDDS_DEFAULT Use all available surfaces.
AMDDS_YUV (AMDDS_YUVOFF | AMDDS_YUVOVR | AMDDS_YUVFLP).
AMDDS_RGB (AMDDS_RGBOFF | AMDDS_RGBOVR | AMDDS_RGBFLP).
AMDDS_PRIMARY (AMDDS_DCIPS | AMDDS_PS).

Return Values

Returns an HRESULT value.

Remarks

It is not always easy to discover which kind of surface is being used by looking at a DDSURFACEDESC structure. Therefore, an application can call GetSurfaceType to retrieve the surface type. The field will be filled in with one bit setting selected from the preceding list of AMDDS definitions.

Requirements

Header: Declared in Amvideo.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also