IBasicVideo::SetDestinationPosition

  • Article
 
Microsoft DirectShow 9.0

IBasicVideo::SetDestinationPosition

The SetDestinationPosition method sets the destination rectangle.

Syntax

  HRESULT SetDestinationPosition(
  long Left,
  long Top,
  long Width,
  long Height
);

Parameters

Left

[in] Specifies the x-coordinate, in pixels.

Top

[in] Specifies the y-coordinate, in pixels.

Width

[in] Specifies the width, in pixels.

Height

[in] Specifies the height, in pixels.

Return Values

Returns an HRESULT value. Possible values include the following.

Value Description
E_INVALIDARG Invalid argument. Width and Height must be larger than zero.
S_OK The method succeeded.
VFW_E_NOT_CONNECTED The video renderer is not connected.

Remarks

This method has the same effect as individually calling the IBasicVideo::put_DestinationLeft, IBasicVideo::put_DestinationTop, IBasicVideo::put_DestinationWidth, and IBasicVideo::put_DestinationHeight methods.

Requirements

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

Library: Use Strmiids.lib.

See Also