Share via


IRTCClient::TemporalSpatialTradeOff

Other versions of this page are also available for the following:

Windows Mobile Not SupportedWindows Embedded CE Supported

8/28/2008

This method gets the temporal-spatial tradeoff for a session. This tradeoff is used for all media streaming:

  • A lower tradeoff value increases the video resolution and decreases the frame rate.
  • A higher value increases the frame rate and decreases the video resolution.

Note

put_TemporalSpatialTradeOff is a non-functional method and cannot be used to set the temporal-spatial tradeoff value. It can be called without error, but RTC will use the same value regardless of what is specified through this method. get_TemporalSpatialTradeOff will correctly retrieve the temporal-spatial tradeoff value.

Syntax

HRESULT put_TemporalSpatialTradeOff(
  long lValue
);
HRESULT get_TemporalSpatialTradeOff(
  long* plValue
);

Parameters

  • lValue
    [in] Temporal-spatial tradeoff value.

    Note

    This parameter will have no effect on the temporal-spatial tradeoff value. The method is non-functional.

    This value is a number between 0 and 255 (on a linear scale), with the default being 128.

    A value of 0 represents the maximum video quality with the lowest frame rate.

    A value of 255 represents the highest frame rate with the lowest quality video resolution.

  • plValue
    [out] Temporal-spatial tradeoff value.

    This value is a number between 0 and 255 (on a linear scale), with the default being 128.

    A value of 0 represents the maximum video quality with the lowest frame rate.

    A value of 255 represents the highest frame rate with the lowest quality video resolution.

Return Value

This method can return an RTC_E_ constant.

The following table shows an additional possible return value.

Value Description

E_INVALIDARG

Value out of range.

Requirements

Header rtccore.h, rtccore.idl
Library uuid.lib
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

IRTCClient