IDirectDrawVideo::GetSurfaceDesc

  • Article
 
Microsoft DirectShow 9.0

IDirectDrawVideo::GetSurfaceDesc

The GetSurfaceDesc method retrieves a DDSURFACEDESC structure describing the current DirectDraw surface.

Syntax

  HRESULT GetSurfaceDesc(
  DDSURFACEDESC *pSurfaceDesc
);

Parameters

pSurfaceDesc

Pointer to a DDSURFACEDESC structure describing the current DirectDraw surface.

Return Values

Returns an HRESULT value. If no surface has been allocated, this method will return E_FAIL. If a DCI primary surface is in use, the DDSURFACEDESC structure will not be filled in and the call will return S_FALSE.

Remarks

Surfaces are allocated only when the renderer is paused. After the renderer has been paused, it cannot release the surfaces when stopped.

Requirements

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

Library: Use Strmiids.lib.

See Also