IWMSBroadcastPublishingPoint.AllowStreamSplitting (C#)

  • Article
  • 2 minutes to read

banner art

Previous Next

IWMSBroadcastPublishingPoint.AllowStreamSplitting (C#)

The AllowStreamSplitting property specifies and retrieves a Boolean value that indicates whether the stream can be split. A cache proxy device can split a stream to minimize network bandwidth. A cache proxy device splits a broadcast stream by making a single connection to an upstream server and then copying the incoming packets to multiple downstream clients.

Syntax

  BroadcastPublishingPoint
  .AllowStreamSplitting
  
  =
  
  bool
  ;
  
  bool
  
  =
  
  BroadcastPublishingPoint
  .AllowStreamSplitting;

Property Value

A bool that indicates whether the stream can be split.

If this property fails, it throws an exception.

Number Description
0xC00D145AL The publishing point has already been removed.

Remarks

The default value is true. This allows the proxy server to split a broadcast so that, regardless of how many clients are connected to the proxy to receive the broadcast, there is only one connection from the proxy server to the origin server. If you set this value to false, there must be one connection between the proxy and the origin server for each client connected to the proxy server.

Example Code

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

// Declare variables.
WMSServer                       Server;
IWMSBroadcastPublishingPoint    BCPubPoint;
IWMSPublishingPoints            PubPoints;
IWMSPublishingPoint             PubPoint;

bool                            bVal;

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

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

    // Retrieve each publishing point and retrieve the
    // IWMSBroadcastPublishingPoint object.
    for (int i = 0; i < PubPoints.Count; i++)
    {
        PubPoint = PubPoints[i];

        if (PubPoint.Type == 
            WMS_PUBLISHING_POINT_TYPE.WMS_PUBLISHING_POINT_TYPE_BROADCAST)
        {
            BCPubPoint = (IWMSBroadcastPublishingPoint)PubPoint;

            // Retrieve a Boolean value indicating whether the
            // stream can be split.
            bVal = BCPubPoint.AllowStreamSplitting;

            // Set the publishing point to disallow 
            // stream splitting.
            BCPubPoint.AllowStreamSplitting = false;
            break;
        }
    }

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