IBasicVideo::SetDestinationPosition method (control.h)

The SetDestinationPosition method sets the destination rectangle.

Syntax

HRESULT SetDestinationPosition(
  [in] long Left,
  [in] long Top,
  [in] long Width,
  [in] long Height
);

Parameters

[in] Left

Specifies the x-coordinate, in pixels.

[in] Top

Specifies the y-coordinate, in pixels.

[in] Width

Specifies the width, in pixels.

[in] Height

Specifies the height, in pixels.

Return value

Returns an HRESULT value. Possible values include the following.

Return code 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

   
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header control.h (include Dshow.h)
Library Strmiids.lib

See also

Error and Success Codes

IBasicVideo Interface