IWMSDataContainerCallback.OnRead (C#)

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

void IWMSDataContainerCallback.OnRead(
  int hr,
  uint dwActualBytesTransferred,
  uint dwChangeType,
  ulong qwChangeParameter,
  ulong qwContext
);

Arguments

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

uint containing the number of bytes of data transferred.

Reserved for future use.

Reserved for future use.

ulong 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 (C#) 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; Windows Server 2008.

See Also

Concepts

IWMSDataContainerCallback Object (C#)