CBaseControlVideo::GetDestinationPosition

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Retrieves the destination rectangle.

Syntax

HRESULT GetDestinationPosition(
  long* pLeft,
  long* pTop,
  long* pWidth,
  long* pHeight
);

Parameters

• pLeft
  Contains the left coordinate.

• pTop
  Contains the top coordinate.

• pWidth
  Contains the width.

• pHeight
  Contains the height.

Return Value

Returns an HRESULT value.

Remarks

This member function can be used in place of separate calls to the CBaseControlVideo::get_DestinationLeft, CBaseControlVideo::get_DestinationTop, CBaseControlVideo::get_DestinationWidth, and CBaseControlVideo::get_DestinationHeight member functions.

An application can change the source and destination rectangles for the video through the IBasicVideo interface.

The source rectangle affects which section of the native video source will appear on the display.

The destination rectangle affects where the video will appear when played. The destination rectangle is relative to the client area of the window in which it is playing.

The upper left corner of the window is coordinate (0,0).

Requirements