InetTransport.BandwidthPolicy

InetTransport     See also    

Defines the method used to apply bandwidth limitations.

Declaration

[C++]
    void setBandwidthPolicy(MCBandwidthPolicy Value);
    MCBandwidthPolicy getBandwidthPolicy(void);

[Pascal]
    property BandwidthPolicy : TMCBandwidthPolicy;

[VB6]
    Property IMCXInetTransport4.BandwidthPolicy As MCXBandwidthPolicy

[ActiveX]
    HRESULT _stdcall IMCInetTransport4.BandwidthPolicy([in] MCXBandwidthPolicy Value );
    HRESULT _stdcall IMCInetTransport4.BandwidthPolicy([out, retval] MCXBandwidthPolicy * Value);

[C#]
    MCBandwidthPolicy BandwidthPolicy;

[VB.NET]
    Public Property BandwidthPolicy As MCBandwidthPolicy

[Java]
    public void setBandwidthPolicy(byte value);
    public byte getBandwidthPolicy();

[Java ME]
    public void setBandwidthPolicy(byte value);
    public byte getBandwidthPolicy();

[Palm]
    void setBandwidthPolicy(MCBandwidthPolicy Value);
    MCBandwidthPolicy getBandwidthPolicy(void);

[DLL]
    void __stdcall MCInetTransportSetBandwidthPolicy(HMCInetTransport h, unsigned long value);
    unsigned long __stdcall MCInetTransportGetBandwidthPolicy(HMCInetTransport h);

Values:

MCBandwidthPolicy
    bpFlexible = 0;
    bpStrict = 1;

Parameters

• h - handle to the object that was returned by Create method

Description

    This property defines how the bandwidth limitations are applied.
    In bpFlexible mode the transport determines data amount allowed to be sent as LimitPerSecond*NumberOfSecondsElapsed-TotalTransferred.
    In bpStrict mode the data amount is calculated on per-second bases as LimitPerSecond-TransferredThisSecond.

    In Flexible mode, if the data is not transferred, "the rest" of the bandwidth is reserved for future use and the next message will be sent faster. In Strict mode the maximum number of bytes that can be sent per second can't be more than LimitPerSecond.
    Generally, bpStrict is better strategy, when the number of messages is unknown and/or when they are small. On the other hand, it leads to slower transfers.

    Default value is bpStrict.