IWMSDataContainer.Read (C#)

The server calls the Read method to read data from the data container into a buffer.

void IWMSDataContainer.Read(
  ref byte[] pbBuffer,
  ulong qwOffset,
  uint dwMaxDataSize,
  uint dwFlags,
  IWMSDataContainerCallback pCallback,
  ulong qwContext


Reference to a byte array identifying the buffer to be filled with data from the data container.

ulong specifying the offset in bytes from which the data should be read. This must be WMS_DATA_CONTAINER_NONSEEKABLE for data containers that do not support seeking. For example, a live source cannot be seekable, but a file can be.

uint specifying the maximum data size in bytes to be read from the data container.

Reserved for future use.

IWMSDataContainerCallbackIWMSDataContainerCallback Object (C#) containing the callback function. The plug-in calls IWMSDataContainerCallback.OnRead to respond to the server.

ulong containing a value defined by the server to identify which Read request the plug-in is responding to when it calls IWMSDataContainerCallback.OnRead. The plug-in 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.


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


IWMSDataContainer Object (C#)