IOverlay::GetClipList (Compact 2013)

  • Article

3/26/2014

This method retrieves the clipping list.

Syntax

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

Parameters

  • pSourceRect
    [out] A pointer to a RECT structure that describes the bounding client rectangle.
  • pDestinationRect
    [in] A pointer to a RECT structure that describes the destination rectangle.
  • ppRgnData
    [out] A pointer to a RGNDATA pointer that contains the header and data that describes clipping. If successful, the Win32 CoTaskMemFree function should free memory.

Return Value

None.

Remarks

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.

Requirements

Header

dshow.h

Library

Strmiids.lib

See Also

Reference

IOverlay Interface