IWMSOnDemandPublishingPoint2.AllowStartupProfile (Visual Basic .NET)

  • Article

banner art

Previous Next

IWMSOnDemandPublishingPoint2.AllowStartupProfile (Visual Basic .NET)

The AllowStartupProfile property specifies and retrieves a Boolean value that indicates whether the publishing point allows clients to use Startup Profile.

  • Note   This property is available only on Windows Server 2003, Enterprise Edition with Service Pack 1; Windows Server 2003, Datacenter Edition with Service Pack 1; and Windows Server 2008.

Syntax

  OnDemandPublishingPoint2
  .AllowStartupProfile
  
  =
  
  Boolean
  ;
  
  Boolean
  
  =
  
  OnDemandPublishingPoint2
  .AllowStartupProfile;

Property Value

A Boolean that indicates whether the publishing point allows the use of Startup Profile.

Remarks

The default value is False.

Startup Profile, also called Advanced Fast Start, is the process by which the server and a client decide the minimum amount of buffering needed to prevent buffer underflow. Data is buffered at a higher rate than the encoded rate of the content by a multiplier value determined by the client. The buffering time is determined by the server. After an adequate amount of data has been buffered, the client begins playing the content.

Advanced Fast Start reduces latency more effectively than Fast Start because only the minimum amount of data is buffered initially.

For more information on Startup Profile and how to encode content to take advantage of it, see "Understanding Advanced Fast Start" in the Windows Media Services 9 Series Help documentation.

Example Code

Imports Microsoft.WindowsMediaServices.Interop
Imports System.Runtime.InteropServices

Private Sub EnableStartupProfile()

    ' Declare variables.
    Dim Server As IWMSServer
    Dim PubPoints As IWMSPublishingPoints
    Dim PubPoint As IWMSPublishingPoint
    Dim ODPubPoint2 As IWMSOnDemandPublishingPoint2
    Dim bVal As Boolean
    Dim i As Integer

    Try

        ' Create a new WMSServer object.
        Server = New WMSServerClass

        ' Retrieve the IWMSPublishingPoints object.
        PubPoints = Server.PublishingPoints

        ' Retrieve each publishing point and retrieve the
        ' IWMSOnDemandPublishingPoint2 object.
        For i = 0 To PubPoints.Count - 1

            PubPoint = PubPoints.Item(i)

            If PubPoint.Type = WMS_PUBLISHING_POINT_TYPE.WMS_PUBLISHING_POINT_TYPE_ON_DEMAND Then
                ODPubPoint2 = PubPoint
                Exit For
            End If
        Next i

    ' Retrieve a Boolean value that indicates whether Startup Profile
    ' functionality is allowed when streaming content to clients.
    bVal = ODPubPoint2.AllowStartupProfile

    ' Set a Boolean value that indicates Startup Profile
    ' functionality is allowed when streaming content to clients.
    ODPubPoint2.AllowStartupProfile = True

    Catch comExc As COMException
        ' TODO: Handle COM exceptions.
    Catch exc As Exception
        ' TODO: Handle exceptions.
    Finally
        ' TODO: Clean-up code goes here.
    End Try

End Sub

Requirements

Reference: Add a reference to Microsoft.WindowsMediaServices

Namespace: Microsoft.WindowsMediaServices.Interop

Assembly: Microsoft.WindowsMediaServices.dll

Library: WMSServerTypeLib.dll

Platform: Windows Server 2003, Enterprise Edition with Service Pack 1; Windows Server 2003, Datacenter Edition with Service Pack 1; Windows Server 2008.

See Also

Previous Next