Share via

IWMSPublishingPointLimits.PlayerCacheDeliveryRate (C#)

  • Article

banner art

Previous Next

IWMSPublishingPointLimits.PlayerCacheDeliveryRate (C#)

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

Syntax

  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 Code

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;
    }

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.

See Also

Previous Next