This method retrieves the clipping list.

HRESULT GetClipList(
  RECT* pSourceRect,
  RECT* pDestinationRect,
  RGNDATA** ppRgnData


  • pSourceRect
    [out] Bounding client rectangle.
  • pDestinationRect
    [in] Destination rectangle.
  • ppRgnData
    [out] Header and data describing clipping. If successful, the Win32 CoTaskMemFree function should free memory.

Return Values



The IOverlay implementation allocates the memory for the clipping rectangles, because it can vary in length. The filter calling this method should free the memory (using CoTaskMemFree) when it is finished with it.


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.

See Also

IOverlay Interface

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.