Share via

IWMSPacketStreamer.Seek (Visual Basic .NET)

  • Article

banner art

Previous Next

IWMSPacketStreamer.Seek (Visual Basic .NET)

The Seek method seeks to a specific offset in a digital media stream.

Syntax

Parameters

pCommand

IWMSCommandContext object containing the associated context.

dwOffsetType

Member of the WMS_SEEK_TYPE enumeration type. This must be one of the following values.

Value Description
WMS_SEEK_TO_BYTE_OFFSET The offset value is specified in bytes.
WMS_SEEK_TO_PACKET The offset value is specified by a packet number.
WMS_SEEK_TO_PLAYLIST_ENTRY The offset value is specified by an index into a playlist.
WMS_SEEK_TO_TIME The offset value is specified in milliseconds.

qwOffset

UInt64 containing the offset value.

dwFlags

Reserved for future use.

pCallback

IWMSPacketStreamerCallback object used to report the status of the method call.

qwContext

UInt64 containing a value defined by the server to identify which call to Seek the plug-in is responding to when it calls IWMSPacketStreamerCallback.OnSeek. You must pass this value back unaltered.

Return Values

This method does not return a value. If the plug-in uses the IWMSEventLog object to log error information, it is recommended that it send NS_E_PLUGIN_ERROR_REPORTED (0xC00D157D) to the server in the lHr parameter. Typically, the server attempts to make plug-in error information available to the server object model, the Windows Event Viewer, and the troubleshooting list in the details pane of the Windows Media Services MMC. However, if the plug-in uses the IWMSEventLog object to log custom error information to the Windows Event Viewer, sending NS_E_PLUGIN_ERROR_REPORTED stops the server from also logging to the event viewer. For more information about plug-in error information, see Identifying Plug-in Errors.

Remarks

If this method returns and does not call Seek on an upstream module in which it passes in the original arguments, the IWMSPacketStreamerCallback.OnSeek method must be called.

The Seek method returns the minimum seek point of all selected streams. When a media parser seeks to a point, it must return all frames after and including the first key frame of the stream. This enables you to ignore partial frames that are after the common seek point but before the next key frame.

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; Windows Server 2003, Datacenter Edition; Windows Server 2008.

See Also

Previous Next