IWMSPacketStreamer.Seek (C#)
.gif)
| Previous | Next |
IWMSPacketStreamer.Seek (C#)
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
ulong containing the offset value.
dwFlags
Reserved for future use.
pCallback
IWMSPacketStreamerCallback object used to report the status of the method call.
qwContext
ulong 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. To report an error, the plug-in can throw a COMException object to the server. If the plug-in uses the IWMSEventLog object to log error information, it is recommended that it throw NS_E_PLUGIN_ERROR_REPORTED (0xC00D157D). 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 send custom error information to the Windows Event Viewer, throwing 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 performs a seek operation, 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 |