ScheduleClip Method (ClipInformation, ClipContext, Object)
Schedules play of a media clip.
Assembly: Microsoft.Web.Media.SmoothStreaming (in Microsoft.Web.Media.SmoothStreaming.dll)
public: ClipContext^ ScheduleClip( ClipInformation^ clipInfo, ClipContext^ clipToAppendTo, Object^ userData )
- Type: Microsoft.Web.Media.SmoothStreaming..::..ClipInformation
A ClipInformation object.
- Type: Microsoft.Web.Media.SmoothStreaming..::..ClipContext
A ClipContext object to which the new clip will be appended.
Return ValueType: Microsoft.Web.Media.SmoothStreaming..::..ClipContext
A ClipContext object.
The method inserts a clip that will play for its duration, after which the stream that was interrupted resumes. Clips can be chained together by using this overload of the method. In that case, the clipToAppendTo parameter is set to the ClipContext instance of another clip. For more information and for examples, see Scheduling Media Clips (IIS Smooth Streaming) and IIS Smooth Streaming Client 1.5.
The object passed in the userData parameter is saved as the Data member of the ClipContext used by the ScheduleClip(ClipInformation, Boolean, Object) method. The application can pass anything it requires in this parameter. The SmoothStreamingMediaElement object is usually included in userData. Later the data can be cast to type SmoothStreamingMediaElement (for example, (SmoothStreamingMediaElement)clipContext.Data) in order to retrieve the Smooth Player that generated the ClipContext instance. If the application requires more information, it can create a class to contain all the information and then pass that type using the userData parameter.
IIS Smooth Streaming Clips scheduled by using ScheduleClip methods require manifests that start at timestamp zero.
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.