IWMSDataContainerCallback.OnRead (Visual Basic .NET)

The OnRead method returns the results of the IWMSDataContainer.Read method call.

IWMSDataContainerCallback.OnRead(  hr As Int32,
  dwActualBytesTransferred As UInt32,
  dwChangeType As UInt32,
  qwChangeParameter As UInt64,
  qwContext As UInt64
)

Arguments

Int32 containing the result of the IWMSDataContainer.Read method call.

UInt32 containing the number of bytes of data transferred.

Reserved for future use.

Reserved for future use.

UInt64 containing a value defined by the server to identify which IWMSDataContainer.Read request the plug-in is responding to when it calls OnRead. The plug-in must pass this value back unaltered.

Return Value

This method does not return a value. If the plug-in uses the IWMSEventLogIWMSEventLog Object (Visual Basic .NET) 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

It is recommended that, if possible, your plug-in read at least one second of data before calling this method.

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; and Windows Server 2008.

See Also

Concepts

IWMSDataContainerCallback Object (Visual Basic .NET)