Share via


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

Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later