IWMSPacketStreamer.GetStreamInfo (C#)

The GetStreamInfo method is called by the server to retrieve header information on streams that are being sent down the data path.

void IWMSPacketStreamer.GetStreamInfo(
  IWMSPacketStreamerCallback pCallback,
  ulong qwContext
);

Arguments

IWMSPacketStreamerCallbackIWMSPacketStreamerCallback Object (C#) used to report the status of the method call.

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

Return Value

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 IWMSEventLogIWMSEventLog Object (C#) 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

This method is called by the server and implemented by media parser, data source, and data sink plug-ins. If this method returns and does not call GetStreamInfo on an upstream module in which it passes in the original arguments, the IWMSPacketStreamerCallback.OnGetStreamInfo method must be called.

The GetStreamInfo method is called every time a source stream changes. For example, it is called once for a simple movie file, and it is called once for each media item in a server-side playlist.

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

Concepts

IWMSPacketStreamer Object (C#)