CBaseControlVideo::GetDestinationPosition

Retrieves the destination rectangle.

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 Values

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

DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header:

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.