IWMSPublishingPointLimits.PlayerCacheDeliveryRate (C#)

The PlayerCacheDeliveryRate property specifies and retrieves the maximum content-delivery rate that a player can request.

int = IWMSPublishingPointLimits.PlayerCacheDeliveryRate;IWMSPublishingPointLimits.PlayerCacheDeliveryRate = int;

Property Value

int containing the maximum rate at which a player can request that content be delivered to its cache. A value of 1000 means normal playback speed; a value of 1500 means 1.5 times normal speed.

If this property fails, it throws an exception.

Number

Description

0x80070057

int is an invalid argument.

Remarks

This value determines how much faster than the encoded bit rate the server is allowed to stream content to a player's cache for opportunistic streaming. Opportunistic streaming allows a player to cache additional data whenever the bandwidth of the connection exceeds the encoded bit rate of the on-demand content. This allows the player to minimize the effects of temporary reductions in network throughput. The default value is 5000, meaning content can be delivered at 5 times the encoded bit rate.

Example

using Microsoft.WindowsMediaServices.Interop;
using System.Runtime.InteropServices;

// Declare variables.
WMSServer                   Server;
IWMSPublishingPoints        PubPoints;
IWMSPublishingPoint         PubPoint;
IWMSPublishingPointLimits   Limits;

int                        iValue;

try {
    // Create a new WMSServer object.
    Server = new WMSServerClass();

    // Retrieve the IWMSPublishingPoints object.
    PubPoints = Server.PublishingPoints;

    // Retrieve information about each publishing point.
    for (int i = 0; i < PubPoints.Count; i++)
    {
        PubPoint = PubPoints[i];

        // Retrieve the IWMSPublishingPointLimits
        // object for the publishing point.
        Limits = PubPoint.Limits;

        // Retrieve the limit for the cache delivery rate to clients.
        iValue = Limits.PlayerCacheDeliveryRate;
        
        // Set the limit for cache delivery to clients.
        Limits.PlayerCacheDeliveryRate = 5000;
    }
}
catch (COMException comExc) {
    // TODO: Handle COM exceptions.
}
catch (Exception e) {
    // TODO: Handle exceptions.
}

Requirements

Reference: Add a reference to Microsoft.WindowsMediaServices.

Namespace: Microsoft.WindowsMediaServices.Interop.

Assembly: Microsoft.WindowsMediaServices.dll.

Library: WMSServerTypeLib.dll.

Platform: Windows ServerĀ 2003 family, Windows ServerĀ 2008 family.