IMSVidCtl::get_MaintainAspectRatio method (msvidctl.h)

  • Article

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

The get_MaintainAspectRatio method queries whether the Video Control maintains the aspect ratio of the source video.

Syntax

HRESULT get_MaintainAspectRatio(
  [out] VARIANT_BOOL *CurrentValue
);

Parameters

[out] CurrentValue

Receives one of the following values.

Value Description
VARIANT_TRUE The Video Control will maintain the aspect ratio of the source video.
VARIANT_FALSE The Video Control will stretch the video to fill the window.

Return value

Returns an HRESULT value. Possible values include the following.

Return code Description
S_OK
 Success.
E_POINTER
 NULL pointer argument.

Requirements

Requirement Value
Minimum supported client Windows�XP [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header msvidctl.h

See also

IMSVidCtl Interface

IMSVidCtl::put_MaintainAspectRatio