IWMSPlaylistParserPlugin.CreatePlaylistParser (Visual Basic .NET)

The CreatePlaylistParser method creates an IWMSPlaylistParserIWMSPlaylistParser Object (Visual Basic .NET) for use by the plug-in.

IWMSPlaylistParserPlugin.CreatePlaylistParser(  pCommandContext As IWMSCommandContext,
  pUser As IWMSContext,
  pPresentation As IWMSContext,
  dwFlags As UInt32,
  pFactory As IWMSClassObject,
  pBufferAllocator As IWMSBufferAllocator,
  pCallback As IWMSPlaylistParserPluginCallback,
  qwContext As UInt64
)

Arguments

	IWMSCommandContextIWMSCommandContext Object (Visual Basic .NET) specifying the request command context that is passed in by the server.
	IWMSContextIWMSContext Object (Visual Basic .NET) specifying the user context that is passed in by the server.
	IWMSContext object specifying the presentation context that is passed in by the server.
	Reserved for future use.
	IWMSClassObjectIWMSClassObject Object (Visual Basic .NET) implemented by the server, that can be used as a class factory to create the other objects.
	IWMSBufferAllocatorIWMSBufferAllocator Object (Visual Basic .NET) to be used to allocate a buffer for reading and writing.
	IWMSPlaylistParserPluginCallbackIWMSPlaylistParserPluginCallback Object (Visual Basic .NET) that is used by the plug-in to report to the server the result of the object creation process.
	UInt64 containing a value defined by the server to identify which call to CreatePlaylistParser the plug-in is responding to when it calls IWMSPlaylistParserPluginCallback.OnCreatePlaylistParser. You must pass this value back unaltered when you call OnCreatePlaylistParser.

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 (Visual Basic .NET) 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 implemented by the plug-in and called by the server.

Example

Public Overloads Sub CreatePlaylistParser( _
    ByVal pCommandContext As IWMSCommandContext, _
    ByVal pUser As IWMSContext, _
    ByVal pPresentation As IWMSContext, _
    ByVal dwFlags As System.UInt32, _
    ByVal pFactory As IWMSClassObject, _
    ByVal pBufferAllocator As IWMSBufferAllocator, _
    ByVal pCallback As IWMSPlaylistParserPluginCallback, _
    ByVal qwContext As System.UInt64) _
    Implements IWMSPlaylistParserPlugin.CreatePlaylistParser

    Dim hr As Integer
    Dim pParser As IWMSPlaylistParser

    pParser = Me
    pCallback.OnCreatePlaylistParser(hr, pParser, qwContext)
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; Windows Server 2003, Datacenter Edition; Windows Server 2008.

See Also

Concepts

IWMSPlaylistParserPlugin Object (Visual Basic .NET)