IDirectDrawVideo::GetSurfaceDesc

  • Article

This method retrieves a DDSURFACEDESC structure describing the current DirectDraw surface.

HRESULT GetSurfaceDesc( 
  DDSURFACEDESC* pSurfaceDesc
);

Parameters

  • pSurfaceDesc
    DDSURFACEDESC structure describing the current DirectDraw surface.

Return Values

Returns an HRESULT value.

Remarks

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. Surfaces are allocated only when the renderer is paused. Once the renderer has been paused, it cannot release the surfaces when stopped.

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.