IWMColorConvProps::SetFullCroppingParam method (wmcodecdsp.h)

Sets the source and destination rectangles.

Syntax

HRESULT SetFullCroppingParam(
  [in] LONG lSrcCropLeft,
  [in] LONG lSrcCropTop,
  [in] LONG lDstCropLeft,
  [in] LONG lDstCropTop,
  [in] LONG lCropWidth,
  [in] LONG lCropHeight
);

Parameters

[in] lSrcCropLeft

Specifies the left edge of the source rectangle, in pixels.

[in] lSrcCropTop

Specifies the top edge of the source rectangle, in pixels.

[in] lDstCropLeft

Specifies the left edge of the destination rectangle, in pixels.

[in] lDstCropTop

Specifies the top edge of the destination rectangle, in pixels.

[in] lCropWidth

Specifies the width of the source and destination rectangles, in pixels.

[in] lCropHeight

Specifies the height of the source and destination rectangles, in pixels.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The method succeeded.

Remarks

By default, the color converter copies the entire video frame. When you call this method, the color converter crops the video to the source rectangle and copies that portion to the destination rectangle.

This method is equivalent to setting the following properties:

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header wmcodecdsp.h

See also

IWMColorConvProps